ticoi 0.1.2__tar.gz

ticoi-0.1.2/.github/script/generate_yml_from_requirement.py

@@ -0,0 +1,36 @@
+import os
+import re
+
+import yaml
+
+
+def parse_requirements(file_path):
+    with open(file_path) as file:
+        lines = file.readlines()
+
+    requirements = {}
+    for line in lines:
+        line = line.strip()
+        if line and not line.startswith("#"):
+            # Using regex to split the package and version constraints
+            match = re.match(r"([a-zA-Z0-9_\-]+)([><=!]=?[\d\.]*)?", line)
+            if match:
+                package = match.group(1)
+                version = match.group(2) if match.group(2) else None
+                requirements[package] = version
+
+    return requirements
+
+
+def generate_yaml(requirements, output_file):
+    with open(output_file, "w") as file:
+        yaml.dump({"dependencies": requirements}, file, default_flow_style=False)
+
+
+requirements_file = f"{os.path.abspath(os.path.join(os.path.dirname(__file__)))}/requirements.txt"
+output_yaml_file = f"{os.path.abspath(os.path.join(os.path.dirname(__file__)))}/ticoi_env.yml"
+
+requirements = parse_requirements(requirements_file)
+generate_yaml(requirements, output_yaml_file)
+
+print(f"Generated {output_yaml_file} from {requirements_file}")

ticoi-0.1.2/.github/workflows/pre-commit.yml

@@ -0,0 +1,14 @@
+name: pre-commit.yml
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  pre-commit:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+    - uses: actions/setup-python@v5
+    - uses: pre-commit/action@v3.0.1

ticoi-0.1.2/.github/workflows/pypi-publish.yml

@@ -0,0 +1,51 @@
+# This workflow will upload a Python Package using hatch when a release is created
+# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-python#publishing-to-package-registries
+#Inspired from https://blog.pecar.me/automate-hatch-publish and https://github.com/shippp/hipp/blob/main/.github/workflows/pypi-publish.yml
+# This workflow uses actions that are not certified by GitHub.
+# They are provided by a third-party and are governed by
+# separate terms of service, privacy policy, and support
+# documentation.
+
+name: Upload Python Package
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  deploy:
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: "3.10"
+        cache: 'pip'
+
+    - name: Install Hatch
+      run: pip install hatch
+
+    # - name: Run tests
+    #   uses: hatch run dev:pytest
+
+    - name: Update version in __about__.py
+      run: |
+        VERSION=${{ github.event.release.tag_name }}
+        VERSION=${VERSION#v}  # strip leading "v" if present
+        sed -i "s/^__version__ = .*/__version__ = \"${VERSION}\"/" src/ticoi/__about__.py
+
+    - name: Build package
+      run: hatch build
+
+    - name: Publish package distribution to Pypi
+      run: hatch publish
+      env:
+        HATCH_INDEX_USER: __token__
+        HATCH_INDEX_AUTH: ${{ secrets.PYPI_TOKEN }}

ticoi-0.1.2/.github/workflows/python-app.yml

@@ -0,0 +1,48 @@
+name: Python test
+
+on:
+  push:
+    branches:
+    - main
+  pull_request:
+    branches:
+    - main
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.sha }}
+  cancel-in-progress: true
+
+env:
+  PYTHONUNBUFFERED: "1"
+  FORCE_COLOR: "1"
+
+jobs:
+  run:
+    name: Python ${{ matrix.python-version }} on ${{ startsWith(matrix.os, 'macos-') && 'macOS' || startsWith(matrix.os, 'windows-') && 'Windows' || 'Linux' }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        python-version: ['3.10', '3.11', '3.12']
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v3
+
+    - name: Install ourself
+      run: |
+        uv pip install --system -e .
+
+    - name: Install hatch
+      run: uv pip install --system hatch
+
+    - name: Run tests
+      run: hatch test --python ${{ matrix.python-version }} --cover-quiet --randomize --parallel --retries 5 --retry-delay 3

ticoi-0.1.2/.gitignore

@@ -0,0 +1,164 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+.idea
+*.py[cod]
+*$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
+
+# 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
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/#use-with-ide
+.pdm.toml
+
+# 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
+.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/
+/examples/results/cube/
+/examples/results/pixel/
+/examples/results/line/

ticoi-0.1.2/.pre-commit-config.yaml

@@ -0,0 +1,40 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    # Ruff version.
+    rev: v0.14.4
+    hooks:
+      # Run the linter.
+      - id: ruff
+        types_or: [python, pyi]
+        args: [--fix, --extend-ignore=E722, --extend-ignore=F821] #ignore bare except and Undefined name, to avoid pb in old code
+      # Run the formatter.
+      - id: ruff-format
+        types_or: [python, pyi]
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: check-added-large-files
+      - id: check-case-conflict
+#      - id: check-executables-have-shebangs
+      - id: check-json
+      - id: check-merge-conflict
+      - id: check-toml
+      - id: check-yaml
+
+  # Replace relative imports
+  - repo: https://github.com/MarcoGorelli/absolufy-imports
+    rev: v0.3.1
+    hooks:
+      - id: absolufy-imports
+
+
+
+
+#  - repo: https://github.com/pre-commit/mirrors-mypy
+#    rev: "v1.15.0"
+#    hooks:
+#      - id: mypy
+#        args: [--ignore-missing-imports, --no-warn-unused-ignores, --allow-untyped-calls,]
+
+

ticoi-0.1.2/.relint.yml

@@ -0,0 +1,4 @@
+#copied from xdem
+- name: Type hint in docstring
+  pattern: ':[r]?type '
+  filePattern: .*\.py

ticoi-0.1.2/CITATION.cff

@@ -0,0 +1,40 @@
+cff-version: 1.2.0
+message: "If you use this software, please cite it as below."
+authors:
+- family-names: "Charrier"
+  given-names: "Laurane"
+- family-names: "Guo"
+  given-names: "Lei"
+title: "TICOI Software"
+version: 1.0.0
+url: "https://github.com/ticoi/ticoi.git"
+preferred-citation:
+  type: article
+  authors:
+    - family-names: Charrier
+      given-names: Laurane
+    - family-names: Dehecq
+      given-names: Amaury
+    - family-names: Guo
+      given-names: Lei
+    - family-names: Brun
+      given-names: Fanny
+    - family-names: Millan
+      given-names: Romain
+    - family-names: Lioret
+      given-names: Nathan
+    - family-names: Copland
+      given-names: Luke
+    - family-names: Maier
+      given-names: Nathan
+    - family-names: Dow
+      given-names: Christine
+    - family-names: Halas
+      given-names: Paul
+  title: "TICOI: an operational Python package to generate regular glacier velocity time series"
+  year: 2025
+  journal: "The Cryosphere"
+  volume: 19
+  start: 4555
+  end: 4583
+  doi: "10.5194/tc-19-4555-2025"

ticoi-0.1.2/CODE_OF_CONDUCT.md

@@ -0,0 +1,82 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, religion, or sexual identity
+and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the
+  overall community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or
+  advances of any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email
+  address, without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official e-mail address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+laurane.charrier at univ-grenoble-alpes.fr.
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.0, available at
+https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
+
+Community Impact Guidelines were inspired by [Mozilla's code of conduct
+enforcement ladder](https://github.com/mozilla/diversity).
+
+[homepage]: https://www.contributor-covenant.org
+
+For answers to common questions about this code of conduct, see the FAQ at
+https://www.contributor-covenant.org/faq. Translations are available at
+https://www.contributor-covenant.org/translations.

ticoi-0.1.2/CONTRIBUTING.md

@@ -0,0 +1,104 @@
+# Contributing Guidelines
+
+:tada: **First off, thank you for considering contributing to TICOI! ** :tada:
+
+The project can still be improved, and all contribitors are welcome!
+These are some of the many ways to contribute:
+
+* :bug: Submitting bug reports and feature requests
+* :memo: Writing tutorials or examples
+* :mag: Fixing typos and improving the documentation
+* :bulb: Writing code for everyone to use
+
+*
+Below is a guide to contributing to TICOI step by step, ensuring tests are passing.
+
+## Overview: making a contribution
+
+The technical steps to contributing to xDEM are:
+
+1. Fork `ticoi/ticoi` and clone your fork repository locally.
+2. Set up the development environment **(see section "Setup" below)**,
+3. Create a branch for the new feature or bug fix,
+4. Make your changes,
+5. Add or modify related tests in `tests/` **(see section "Tests" below)**,
+6. Commit your changes,
+7. Run `pre-commit` separately if not installed as git hook **(see section "Linting" below)**,
+8. Push to your fork,
+9. Open a pull request from GitHub to discuss and eventually merge.
+
+## Development environment
+
+TICOI currently supports Python versions of 3.10 to 3.11, which are
+tested in a continuous integration (CI) workflow running on GitHub Actions.
+
+When you open a PR on TICOI, a single linting action and 1 test actions will automatically start, corresponding to all
+supported Python versions (3.11).
+
+### Setup
+
+#### With `mamba`
+Clone the git repo and create a `mamba` environment (see how to install `mamba` in the [mamba documentation](https://mamba.readthedocs.io/en/latest/)):
+
+```bash
+git clone git@github.com:ticoi/ticoi.git
+cd ticoi
+mamba env create -f environment.yml -n ticoi_env  # change the name if you want
+mamba activate ticoi_env  # Or any other name specified above
+```
+#### With `pip`
+```bash
+git clone git@github.com:ticoi/ticoi.git
+cd ticoi
+make install
+```
+
+### Tests
+
+At least one test per feature (in the associated `tests/test_*.py` file) should be included in the PR, using `pytest` (see existing tests for examples).
+The structure of test modules and functions in `tests/` largely mirrors that of the package modules and functions in `ticoi/`.
+
+To run the entire test suite, run `pytest` from the root of the repository:
+```bash
+pytest
+```
+### Formatting and linting
+
+Install and run `pre-commit` from the root of the repository (such as with `mamba install pre-commit`, see [pre-commit documentation](https://pre-commit.com/) for details),
+which will use `.pre-commit-config.yaml` to verify spelling errors, import sorting, type checking, formatting and linting:
+
+```bash
+pre-commit install #optional: to install pre-commit as a git-hook, to ensure checks have to pass before committing.
+pre-commit run --all
+```
+
+You can then commit and push those changes.
+
+### Final steps
+
+That's it! If the tests are passing, or if you need help to make those work, you can open a PR.
+
+We'll receive word of your PR as soon as it is opened, and should follow up shortly to discuss the changes, and eventually give approval to merge. Thank you so much for contributing!
+
+### Rights
+
+The license (see LICENSE) applies to all contributions.
+
+
+### Understanding the structure of the code
+
+#### Main code
+
+* **core.py**: Main functions to process the temporal inversion of glacier's surface velocity using
+  the TICOI method. The inversion is solved using an Iterative Reweighted Least Square, and a robust downweighted
+  function (Tukey's biweight).
+* **cube_data_classxr.py**: Class object to store and manipulate velocity observation data in a cube (netcdf or zarr)
+* **pixel_class.py**: Class object to manipulate and visualize velocity observations and inverted results on a pixel (from a pandas dataframe, or inside a cube)
+* **inversion_functions.py**: Functions to process the temporal inversion.
+* **interpolation_functions.py**: Functions to process the temporal interpolation.
+* **filtering_functions.py**: Functions to process some filtering.
+* **utils.py**: Two other functions for accessing ITS_LIVE data.
+* **mjd2date.py**: Functions to convert the dates from Modified Julian Date to Gregorian Date
+
+
+