| Name | seabird-processing JSON |
| Version |
0.2.0
JSON |
| download |
| home_page | |
| Summary | Python interface for calling Seabird CTD processing commands |
| upload_time | 2023-08-11 20:03:19 |
| maintainer | |
| docs_url | None |
| author | Taylor Denouden |
| requires_python | >=3.9,<4.0 |
| license | MIT |
| keywords |
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Seabird-Processing
Python bindings for executing Seabird SBE processing tools.
## Description
This library contains an API for executing seabird SBE processing modules on Seabird
data files (hex and cnv). The modules all accept text as input which allows for more
convenient access to the command line functions which would normally require a file path
as input. Under the hood, this library simply saves temporary files which are then
processed through SBE, read into memory, and returned as in-memory text.
## Installation
### Pre-requisites
An installation of
the [Seabird Processing Suite](http://www.seabird.com/software/software) is required to
run these modules since they simply provide an abstraction of the command line tools
provided by Seabird.
### Install with pip
To install this tool in your current python environment do:
```pip install seabird-processing```
Configure the tool with the location of your Seabird Processing Suite installation by
setting the `SBE_BIN_DIR` environment variable. For example, if you installed the
software to `C:\Program Files (x86)\Seabird\SBEDataProcessing-Win32` then you would set
the environment
variable `SBE_BIN_DIR=C:\Program Files (x86)\Seabird\SBEDataProcessing-Win32\`.
By default, it is assumed that the software is installed
to `C:\Program Files (x86)\Seabird\SBEDataProcessing-Win32`.
## Usage
There are two ways to use this library. The first is to use individual functions which
correspond one-to-one with the SBE processing modules. The second is to use
the `Pipeline`
class which allows you to chain together multiple processing modules.
### Command line functions
```python
from seabird_processing import dat_cnv, filter_
xmlcon = './xmlcon/19-7467.xmlcon'
cnvfile = dat_cnv('./seabird_data_file.hex', './output/dir', xmlcon, './psa/DatCnv.psa')
# "filter" is a reserved keyword, so this function is called "filter_"
filtered = filter_(cnvfile, './output/dir', xmlcon, './psa/AlignCTD.psa')
# ...
```
### Batch processing
```python
from seabird_processing import Batch, configs
xmlcon = './path/to/xmlcon/12-3456.xmlcon'
# Create a pipeline with some config files
batch = Batch([
configs.DatCnvConfig(
# `output_file_suffix` is optional
output_dir="./datcnv", output_file_suffix="_datcnv",
xmlcon=xmlcon, psa='./path/to/DatCnv.psa'),
configs.FilterConfig(
output_dir="./filter", output_file_suffix="_filter",
xmlcon=xmlcon, psa='./path/to/Filter.psa'),
configs.AlignCTDConfig(
output_dir="./alignctd", output_file_suffix="_alignctd",
xmlcon=xmlcon, psa='./path/to/AlignCTD.psa'),
configs.CellTMConfig(
output_dir="./celltm", output_file_suffix="_celltm",
xmlcon=xmlcon, psa='./path/to/CellTM.psa'),
configs.LoopEditConfig(
output_dir="./loopedit", output_file_suffix="_loopedit",
xmlcon=xmlcon, psa='./path/to/LoopEdit.psa'),
configs.DeriveConfig(
output_dir="./derive", output_file_suffix="_derive",
xmlcon=xmlcon, psa='./path/to/Derive.psa'),
configs.DeriveTEOS10Config(
output_dir="./deriveteos10", output_file_suffix="_deriveteos10",
xmlcon=xmlcon, psa='./path/to/DeriveTEOS_10.psa'),
configs.BinAvgConfig(
output_dir="./binavg", output_file_suffix="_binavg",
xmlcon=xmlcon, psa='./path/to/BinAvg.psa'),
])
batch.run("./*.hex")
# You may also run an individual Config object
converter = configs.DatCnvConfig(
output_dir="./datcnv", output_file_suffix="_datcnv",
xmlcon=xmlcon, psa='./path/to/DatCnv.psa'
)
converter.run("./some/file.hex")
```
### Copyright and Licensing Information
See [LICENSE](./LICENSE) for details.
### Bugs / Feature requests
Please file bug reports and feature requests on GitHub. We also welcome pull requests
to add functionality or fix bugs!
Raw data
{
"_id": null,
"home_page": "",
"name": "seabird-processing",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.9,<4.0",
"maintainer_email": "",
"keywords": "",
"author": "Taylor Denouden",
"author_email": "taylor.denouden@hakai.org",
"download_url": "https://files.pythonhosted.org/packages/8e/50/1c058d11a5e87bc3848f127089516b9d95a1c1924a3b10012ad967a82160/seabird_processing-0.2.0.tar.gz",
"platform": null,
"description": "# Seabird-Processing\n\nPython bindings for executing Seabird SBE processing tools.\n\n## Description\n\nThis library contains an API for executing seabird SBE processing modules on Seabird\ndata files (hex and cnv). The modules all accept text as input which allows for more\nconvenient access to the command line functions which would normally require a file path\nas input. Under the hood, this library simply saves temporary files which are then\nprocessed through SBE, read into memory, and returned as in-memory text.\n\n## Installation\n\n### Pre-requisites\n\nAn installation of\nthe [Seabird Processing Suite](http://www.seabird.com/software/software) is required to\nrun these modules since they simply provide an abstraction of the command line tools\nprovided by Seabird.\n\n### Install with pip\n\nTo install this tool in your current python environment do:\n\n```pip install seabird-processing```\n\nConfigure the tool with the location of your Seabird Processing Suite installation by\nsetting the `SBE_BIN_DIR` environment variable. For example, if you installed the\nsoftware to `C:\\Program Files (x86)\\Seabird\\SBEDataProcessing-Win32` then you would set\nthe environment\nvariable `SBE_BIN_DIR=C:\\Program Files (x86)\\Seabird\\SBEDataProcessing-Win32\\`.\nBy default, it is assumed that the software is installed\nto `C:\\Program Files (x86)\\Seabird\\SBEDataProcessing-Win32`.\n\n## Usage\n\nThere are two ways to use this library. The first is to use individual functions which\ncorrespond one-to-one with the SBE processing modules. The second is to use\nthe `Pipeline`\nclass which allows you to chain together multiple processing modules.\n\n### Command line functions\n\n```python\nfrom seabird_processing import dat_cnv, filter_\n\nxmlcon = './xmlcon/19-7467.xmlcon'\n\ncnvfile = dat_cnv('./seabird_data_file.hex', './output/dir', xmlcon, './psa/DatCnv.psa')\n# \"filter\" is a reserved keyword, so this function is called \"filter_\"\nfiltered = filter_(cnvfile, './output/dir', xmlcon, './psa/AlignCTD.psa')\n# ...\n```\n\n### Batch processing\n\n```python\nfrom seabird_processing import Batch, configs\n\nxmlcon = './path/to/xmlcon/12-3456.xmlcon'\n\n# Create a pipeline with some config files\nbatch = Batch([\n configs.DatCnvConfig(\n # `output_file_suffix` is optional\n output_dir=\"./datcnv\", output_file_suffix=\"_datcnv\",\n xmlcon=xmlcon, psa='./path/to/DatCnv.psa'),\n configs.FilterConfig(\n output_dir=\"./filter\", output_file_suffix=\"_filter\",\n xmlcon=xmlcon, psa='./path/to/Filter.psa'),\n configs.AlignCTDConfig(\n output_dir=\"./alignctd\", output_file_suffix=\"_alignctd\",\n xmlcon=xmlcon, psa='./path/to/AlignCTD.psa'),\n configs.CellTMConfig(\n output_dir=\"./celltm\", output_file_suffix=\"_celltm\",\n xmlcon=xmlcon, psa='./path/to/CellTM.psa'),\n configs.LoopEditConfig(\n output_dir=\"./loopedit\", output_file_suffix=\"_loopedit\",\n xmlcon=xmlcon, psa='./path/to/LoopEdit.psa'),\n configs.DeriveConfig(\n output_dir=\"./derive\", output_file_suffix=\"_derive\",\n xmlcon=xmlcon, psa='./path/to/Derive.psa'),\n configs.DeriveTEOS10Config(\n output_dir=\"./deriveteos10\", output_file_suffix=\"_deriveteos10\",\n xmlcon=xmlcon, psa='./path/to/DeriveTEOS_10.psa'),\n configs.BinAvgConfig(\n output_dir=\"./binavg\", output_file_suffix=\"_binavg\",\n xmlcon=xmlcon, psa='./path/to/BinAvg.psa'),\n])\n\nbatch.run(\"./*.hex\")\n\n# You may also run an individual Config object\nconverter = configs.DatCnvConfig(\n output_dir=\"./datcnv\", output_file_suffix=\"_datcnv\",\n xmlcon=xmlcon, psa='./path/to/DatCnv.psa'\n)\nconverter.run(\"./some/file.hex\")\n```\n\n### Copyright and Licensing Information\n\nSee [LICENSE](./LICENSE) for details.\n\n### Bugs / Feature requests\n\nPlease file bug reports and feature requests on GitHub. We also welcome pull requests\nto add functionality or fix bugs!\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Python interface for calling Seabird CTD processing commands",
"version": "0.2.0",
"project_urls": null,
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "472278e02796bc87b44b966c8869b839566b2e8b9cff6076ec819cd531c048f5",
"md5": "765e8522d14c52f5c8244204cbea33a4",
"sha256": "97de76bcc87d3afc4e30eafe8316e1851fb36be05f2336adf03da55b22f30aa6"
},
"downloads": -1,
"filename": "seabird_processing-0.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "765e8522d14c52f5c8244204cbea33a4",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9,<4.0",
"size": 8600,
"upload_time": "2023-08-11T20:03:18",
"upload_time_iso_8601": "2023-08-11T20:03:18.502627Z",
"url": "https://files.pythonhosted.org/packages/47/22/78e02796bc87b44b966c8869b839566b2e8b9cff6076ec819cd531c048f5/seabird_processing-0.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "8e501c058d11a5e87bc3848f127089516b9d95a1c1924a3b10012ad967a82160",
"md5": "e7fb6d263527f5f4f577091319778a38",
"sha256": "41fee1533a1d6f1474bb2d91dd7e06e1e20678efd568f10c127cea44eb278888"
},
"downloads": -1,
"filename": "seabird_processing-0.2.0.tar.gz",
"has_sig": false,
"md5_digest": "e7fb6d263527f5f4f577091319778a38",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9,<4.0",
"size": 8075,
"upload_time": "2023-08-11T20:03:19",
"upload_time_iso_8601": "2023-08-11T20:03:19.436380Z",
"url": "https://files.pythonhosted.org/packages/8e/50/1c058d11a5e87bc3848f127089516b9d95a1c1924a3b10012ad967a82160/seabird_processing-0.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-08-11 20:03:19",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "seabird-processing"
}
