qdc-converter


Nameqdc-converter JSON
Version 2.5 PyPI version JSON
download
home_pagehttp://github.com/interlark/qdc-converter
SummaryGarmin QDC (Quickdraw Contours) Converter
upload_time2022-06-23 20:24:20
maintainer
docs_urlNone
authorAndy Trofimov
requires_python>=3.6
licenseMIT
keywords qdc garmin converter
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls. 
            [Русский](https://github.com/interlark/qdc-converter/blob/main/README.md) | [English](https://github.com/interlark/qdc-converter/blob/main/README.en.md)

# QDC Конвертер
[![Tests](https://github.com/interlark/qdc-converter/actions/workflows/tests.yml/badge.svg)](https://github.com/interlark/qdc-converter/actions/workflows/tests.yml)
[![PyPi version](https://badgen.net/pypi/v/qdc-converter)](https://pypi.org/project/qdc-converter)
[![Supported Python versions](https://badgen.net/pypi/python/qdc-converter)](https://pypi.org/project/qdc-converter)
[![License](https://badgen.net/pypi/license/qdc-converter)](https://github.com/interlark/qdc-converter/blob/main/LICENSE)

Конвертер ***.qdc** *(Garmin QuickDraw Contours)* в таблицу ***.csv** *(CSV таблица)* или ***.grd** *(Растр ESRI ASCII Grid)*

![Screencast](https://user-images.githubusercontent.com/20641837/175391112-c11a74c1-5b84-444a-a2b7-ca611d933f36.gif)

## Установка
### Установка одним файлом
Скачать [релиз](https://github.com/interlark/qdc-converter/releases/latest).

### Установка из PyPI
```bash
# CLI
pip install qdc-converter
# CLI + GUI
pip install qdc-converter[gui]
```

### Установка из репозитория
```bash
git clone https://github.com/interlark/qdc-converter
cd qdc-converter

python -m venv venv

# Windows
.\venv\Scripts\activate.bat
# Linux, MacOS
. venv/bin/activate

# CLI
pip install .
# CLI + GUI
pip install .[gui]
```

## Использование
Основные параметры: **-i**, **-o** и **-l**.

* Пример конвертирования папки ```Contours``` с вложенными ***.qdc** файлами в таблицу ```export_table.csv``` с 3 полями ```X``` *(долгота в десятичных градусах)*, ```Y``` *(широта в десятичных градусах)* и  ```Depth(m)``` *(глубина в метрах)*, используя слой данных L_**1**:
  ```
  qdc-converter -i "Contours" -o "export_table.csv" -l 1
  ```

* Пример конвертирования папки ```Contours``` с вложенными ***.qdc** файлами в растр ```export_raster.grd```, используя слой данных L_**0**:
  ```
  qdc-converter -i "Contours" -o "export_raster.grd" -l 0
  ```
  Полученный растр можно загрузить во многие ГИС (например, QGIS) и сконвертировать в более быстрочитаемый формат.


## Параметры
```bash
qdc-converter --help
```
```
Usage: qdc-converter [OPTIONS]

  QDC Конвертер.

  Конвертер Garmin's QDC файлов в CSV или GRD.

Options:
  Основные параметры:             Ключевые параметры конвертера
    -i, --qdc-folder-path DIRECTORY
                                  Путь до папки со вложенными контурами
                                  QuickDraw Contours (QDC).  [required]

    -o, --output-path FILE        Путь до сконвертированного файла (*.csv или
                                  *.grd).  [required]

    -l, --layer [0,1,2,3,4,5]     Слой данных (0 - Raw user data, 1 -
                                  Recommended).  [0<=x<=5; required]
  Параметры корректировки:        Корректировки
    -dx, --x-correction FLOAT     Корректировка X.
    -dy, --y-correction FLOAT     Корректировка Y.
    -dz, --z-correction FLOAT     Корректировка Z.
  CSV Параметры:                  Параметры касающиеся записи CSV таблицы
    -csvd, --csv-delimiter TEXT   CSV разделитель значений колонок (по-умолчанию ",").
    -csvs, --csv-skip-headers     Не записывать заголовок таблицы.
    -csvy, --csv-yxz              Изменить порядок записи с X,Y,Z на Y,X,Z в
                                  CSV таблице.
  Другие параметры:               Другие параметры конвертера
    -st, --singlethreaded         Запустить конвертер в одном потоке.
    -vc, --validity-codes         Записывать код качества вместо глубины.
    -q, --quite                   "Молчаливый режим"
  --version                       Show the version and exit.
  --help                          Show this message and exit.
```

Raw data

            {
    "_id": null,
    "home_page": "http://github.com/interlark/qdc-converter",
    "name": "qdc-converter",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.6",
    "maintainer_email": "",
    "keywords": "qdc garmin converter",
    "author": "Andy Trofimov",
    "author_email": "interlark@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/49/55/6fba73177fc769279937e02691a773802f052411e6225c2d5f76889d291f/qdc-converter-2.5.tar.gz",
    "platform": null,
    "description": "[\u0420\u0443\u0441\u0441\u043a\u0438\u0439](https://github.com/interlark/qdc-converter/blob/main/README.md) | [English](https://github.com/interlark/qdc-converter/blob/main/README.en.md)\n\n# QDC \u041a\u043e\u043d\u0432\u0435\u0440\u0442\u0435\u0440\n[![Tests](https://github.com/interlark/qdc-converter/actions/workflows/tests.yml/badge.svg)](https://github.com/interlark/qdc-converter/actions/workflows/tests.yml)\n[![PyPi version](https://badgen.net/pypi/v/qdc-converter)](https://pypi.org/project/qdc-converter)\n[![Supported Python versions](https://badgen.net/pypi/python/qdc-converter)](https://pypi.org/project/qdc-converter)\n[![License](https://badgen.net/pypi/license/qdc-converter)](https://github.com/interlark/qdc-converter/blob/main/LICENSE)\n\n\u041a\u043e\u043d\u0432\u0435\u0440\u0442\u0435\u0440 ***.qdc** *(Garmin QuickDraw Contours)* \u0432 \u0442\u0430\u0431\u043b\u0438\u0446\u0443 ***.csv** *(CSV \u0442\u0430\u0431\u043b\u0438\u0446\u0430)* \u0438\u043b\u0438 ***.grd** *(\u0420\u0430\u0441\u0442\u0440 ESRI ASCII Grid)*\n\n![Screencast](https://user-images.githubusercontent.com/20641837/175391112-c11a74c1-5b84-444a-a2b7-ca611d933f36.gif)\n\n## \u0423\u0441\u0442\u0430\u043d\u043e\u0432\u043a\u0430\n### \u0423\u0441\u0442\u0430\u043d\u043e\u0432\u043a\u0430 \u043e\u0434\u043d\u0438\u043c \u0444\u0430\u0439\u043b\u043e\u043c\n\u0421\u043a\u0430\u0447\u0430\u0442\u044c [\u0440\u0435\u043b\u0438\u0437](https://github.com/interlark/qdc-converter/releases/latest).\n\n### \u0423\u0441\u0442\u0430\u043d\u043e\u0432\u043a\u0430 \u0438\u0437 PyPI\n```bash\n# CLI\npip install qdc-converter\n# CLI + GUI\npip install qdc-converter[gui]\n```\n\n### \u0423\u0441\u0442\u0430\u043d\u043e\u0432\u043a\u0430 \u0438\u0437 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u044f\n```bash\ngit clone https://github.com/interlark/qdc-converter\ncd qdc-converter\n\npython -m venv venv\n\n# Windows\n.\\venv\\Scripts\\activate.bat\n# Linux, MacOS\n. venv/bin/activate\n\n# CLI\npip install .\n# CLI + GUI\npip install .[gui]\n```\n\n## \u0418\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u0435\n\u041e\u0441\u043d\u043e\u0432\u043d\u044b\u0435 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b: **-i**, **-o** \u0438 **-l**.\n\n* \u041f\u0440\u0438\u043c\u0435\u0440 \u043a\u043e\u043d\u0432\u0435\u0440\u0442\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u044f \u043f\u0430\u043f\u043a\u0438 ```Contours``` \u0441 \u0432\u043b\u043e\u0436\u0435\u043d\u043d\u044b\u043c\u0438 ***.qdc** \u0444\u0430\u0439\u043b\u0430\u043c\u0438 \u0432 \u0442\u0430\u0431\u043b\u0438\u0446\u0443 ```export_table.csv``` \u0441 3 \u043f\u043e\u043b\u044f\u043c\u0438 ```X``` *(\u0434\u043e\u043b\u0433\u043e\u0442\u0430 \u0432 \u0434\u0435\u0441\u044f\u0442\u0438\u0447\u043d\u044b\u0445 \u0433\u0440\u0430\u0434\u0443\u0441\u0430\u0445)*, ```Y``` *(\u0448\u0438\u0440\u043e\u0442\u0430 \u0432 \u0434\u0435\u0441\u044f\u0442\u0438\u0447\u043d\u044b\u0445 \u0433\u0440\u0430\u0434\u0443\u0441\u0430\u0445)* \u0438  ```Depth(m)``` *(\u0433\u043b\u0443\u0431\u0438\u043d\u0430 \u0432 \u043c\u0435\u0442\u0440\u0430\u0445)*, \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u044f \u0441\u043b\u043e\u0439 \u0434\u0430\u043d\u043d\u044b\u0445 L_**1**:\n  ```\n  qdc-converter -i \"Contours\" -o \"export_table.csv\" -l 1\n  ```\n\n* \u041f\u0440\u0438\u043c\u0435\u0440 \u043a\u043e\u043d\u0432\u0435\u0440\u0442\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u044f \u043f\u0430\u043f\u043a\u0438 ```Contours``` \u0441 \u0432\u043b\u043e\u0436\u0435\u043d\u043d\u044b\u043c\u0438 ***.qdc** \u0444\u0430\u0439\u043b\u0430\u043c\u0438 \u0432 \u0440\u0430\u0441\u0442\u0440 ```export_raster.grd```, \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u044f \u0441\u043b\u043e\u0439 \u0434\u0430\u043d\u043d\u044b\u0445 L_**0**:\n  ```\n  qdc-converter -i \"Contours\" -o \"export_raster.grd\" -l 0\n  ```\n  \u041f\u043e\u043b\u0443\u0447\u0435\u043d\u043d\u044b\u0439 \u0440\u0430\u0441\u0442\u0440 \u043c\u043e\u0436\u043d\u043e \u0437\u0430\u0433\u0440\u0443\u0437\u0438\u0442\u044c \u0432\u043e \u043c\u043d\u043e\u0433\u0438\u0435 \u0413\u0418\u0421 (\u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440, QGIS) \u0438 \u0441\u043a\u043e\u043d\u0432\u0435\u0440\u0442\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u0432 \u0431\u043e\u043b\u0435\u0435 \u0431\u044b\u0441\u0442\u0440\u043e\u0447\u0438\u0442\u0430\u0435\u043c\u044b\u0439 \u0444\u043e\u0440\u043c\u0430\u0442.\n\n\n## \u041f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b\n```bash\nqdc-converter --help\n```\n```\nUsage: qdc-converter [OPTIONS]\n\n  QDC \u041a\u043e\u043d\u0432\u0435\u0440\u0442\u0435\u0440.\n\n  \u041a\u043e\u043d\u0432\u0435\u0440\u0442\u0435\u0440 Garmin's QDC \u0444\u0430\u0439\u043b\u043e\u0432 \u0432 CSV \u0438\u043b\u0438 GRD.\n\nOptions:\n  \u041e\u0441\u043d\u043e\u0432\u043d\u044b\u0435 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b:             \u041a\u043b\u044e\u0447\u0435\u0432\u044b\u0435 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b \u043a\u043e\u043d\u0432\u0435\u0440\u0442\u0435\u0440\u0430\n    -i, --qdc-folder-path DIRECTORY\n                                  \u041f\u0443\u0442\u044c \u0434\u043e \u043f\u0430\u043f\u043a\u0438 \u0441\u043e \u0432\u043b\u043e\u0436\u0435\u043d\u043d\u044b\u043c\u0438 \u043a\u043e\u043d\u0442\u0443\u0440\u0430\u043c\u0438\n                                  QuickDraw Contours (QDC).  [required]\n\n    -o, --output-path FILE        \u041f\u0443\u0442\u044c \u0434\u043e \u0441\u043a\u043e\u043d\u0432\u0435\u0440\u0442\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u043e\u0433\u043e \u0444\u0430\u0439\u043b\u0430 (*.csv \u0438\u043b\u0438\n                                  *.grd).  [required]\n\n    -l, --layer [0,1,2,3,4,5]     \u0421\u043b\u043e\u0439 \u0434\u0430\u043d\u043d\u044b\u0445 (0 - Raw user data, 1 -\n                                  Recommended).  [0<=x<=5; required]\n  \u041f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b \u043a\u043e\u0440\u0440\u0435\u043a\u0442\u0438\u0440\u043e\u0432\u043a\u0438:        \u041a\u043e\u0440\u0440\u0435\u043a\u0442\u0438\u0440\u043e\u0432\u043a\u0438\n    -dx, --x-correction FLOAT     \u041a\u043e\u0440\u0440\u0435\u043a\u0442\u0438\u0440\u043e\u0432\u043a\u0430 X.\n    -dy, --y-correction FLOAT     \u041a\u043e\u0440\u0440\u0435\u043a\u0442\u0438\u0440\u043e\u0432\u043a\u0430 Y.\n    -dz, --z-correction FLOAT     \u041a\u043e\u0440\u0440\u0435\u043a\u0442\u0438\u0440\u043e\u0432\u043a\u0430 Z.\n  CSV \u041f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b:                  \u041f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b \u043a\u0430\u0441\u0430\u044e\u0449\u0438\u0435\u0441\u044f \u0437\u0430\u043f\u0438\u0441\u0438 CSV \u0442\u0430\u0431\u043b\u0438\u0446\u044b\n    -csvd, --csv-delimiter TEXT   CSV \u0440\u0430\u0437\u0434\u0435\u043b\u0438\u0442\u0435\u043b\u044c \u0437\u043d\u0430\u0447\u0435\u043d\u0438\u0439 \u043a\u043e\u043b\u043e\u043d\u043e\u043a (\u043f\u043e-\u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e \",\").\n    -csvs, --csv-skip-headers     \u041d\u0435 \u0437\u0430\u043f\u0438\u0441\u044b\u0432\u0430\u0442\u044c \u0437\u0430\u0433\u043e\u043b\u043e\u0432\u043e\u043a \u0442\u0430\u0431\u043b\u0438\u0446\u044b.\n    -csvy, --csv-yxz              \u0418\u0437\u043c\u0435\u043d\u0438\u0442\u044c \u043f\u043e\u0440\u044f\u0434\u043e\u043a \u0437\u0430\u043f\u0438\u0441\u0438 \u0441 X,Y,Z \u043d\u0430 Y,X,Z \u0432\n                                  CSV \u0442\u0430\u0431\u043b\u0438\u0446\u0435.\n  \u0414\u0440\u0443\u0433\u0438\u0435 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b:               \u0414\u0440\u0443\u0433\u0438\u0435 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b \u043a\u043e\u043d\u0432\u0435\u0440\u0442\u0435\u0440\u0430\n    -st, --singlethreaded         \u0417\u0430\u043f\u0443\u0441\u0442\u0438\u0442\u044c \u043a\u043e\u043d\u0432\u0435\u0440\u0442\u0435\u0440 \u0432 \u043e\u0434\u043d\u043e\u043c \u043f\u043e\u0442\u043e\u043a\u0435.\n    -vc, --validity-codes         \u0417\u0430\u043f\u0438\u0441\u044b\u0432\u0430\u0442\u044c \u043a\u043e\u0434 \u043a\u0430\u0447\u0435\u0441\u0442\u0432\u0430 \u0432\u043c\u0435\u0441\u0442\u043e \u0433\u043b\u0443\u0431\u0438\u043d\u044b.\n    -q, --quite                   \"\u041c\u043e\u043b\u0447\u0430\u043b\u0438\u0432\u044b\u0439 \u0440\u0435\u0436\u0438\u043c\"\n  --version                       Show the version and exit.\n  --help                          Show this message and exit.\n```\n\n\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "Garmin QDC (Quickdraw Contours) Converter",
    "version": "2.5",
    "split_keywords": [
        "qdc",
        "garmin",
        "converter"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "817334927be0773807a26af77608a0a5",
                "sha256": "f9c973c7dd68f53318f1cdb9c5cfd15b5b2a365095ccec8ba36ee72e7c775cff"
            },
            "downloads": -1,
            "filename": "qdc_converter-2.5-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "817334927be0773807a26af77608a0a5",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.6",
            "size": 91528,
            "upload_time": "2022-06-23T20:24:19",
            "upload_time_iso_8601": "2022-06-23T20:24:19.109901Z",
            "url": "https://files.pythonhosted.org/packages/bb/5c/560915836ae20e57e1d9622721ee75e8714d7d4bb2b2ce1ea80a407484f5/qdc_converter-2.5-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "c4399c7a330b546752f7a4bc628a0bb7",
                "sha256": "77ebc229fcc46ab95db5e1fd1f14dc237ed856103bb6b7a9ea42d24932b19a16"
            },
            "downloads": -1,
            "filename": "qdc-converter-2.5.tar.gz",
            "has_sig": false,
            "md5_digest": "c4399c7a330b546752f7a4bc628a0bb7",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.6",
            "size": 92893,
            "upload_time": "2022-06-23T20:24:20",
            "upload_time_iso_8601": "2022-06-23T20:24:20.739979Z",
            "url": "https://files.pythonhosted.org/packages/49/55/6fba73177fc769279937e02691a773802f052411e6225c2d5f76889d291f/qdc-converter-2.5.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2022-06-23 20:24:20",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "github_user": "interlark",
    "github_project": "qdc-converter",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "qdc-converter"
}
Andy Trofimov
Elapsed time: 0.61622s