wassfast


Namewassfast JSON
Version 1.5.6 PyPI version JSON
download
home_pageNone
SummaryThe next-generation stereo processing pipeline for sea waves 3D reconstruction.
upload_time2025-01-08 11:11:37
maintainerNone
docs_urlNone
authorFilippo Bergamasco
requires_python>=3.8
licenseGPL3
keywords wass 3d sea-waves
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            WASSfast is the next-generation stereo processing pipeline for sea waves 3D reconstruction. It exploits the linear dispertion relation and sparse feature triangulation to resolve sea-surface elevation in quasi real-time. At present state, WASSfast can work in two operating modes:

1) Predict-Update (PU) mode. See the [paper](https://www.sciencedirect.com/science/article/pii/S0098300420306385)

2) Convolutional Neural Network (CNN) mode (suggested). See the [paper](https://www.mdpi.com/2072-4292/13/18/3780/pdf)


For the standard pipeline see [http://www.dais.unive.it/wass](http://www.dais.unive.it/wass)

**Note** Due to TensorFlow version incompatibilities, WASSfast installed via Pypi supports CNN mode only.

## How to use it

Install via pip:

```
python -m pip install wassfast
```

and run `wassfast --help` for a brief description of the command-line options.


## Try it with test data

1. Download the [test data](https://www.dais.unive.it/wass/wassfast_testdata_256.7z)
2. Extract the test data ```7z x wassfast_testdata_256.7z```. This will create
   a directory named `wassfast_testdata_256`
3. Enter the newly extracted directory: `cd wassfast_testdata_256`
4. Execute WASSfast:

```
wassfast ./input ./config256.mat ./config ./settings.cfg RLTB CNN --batchsize 16 -n 49 -r 15.0 -o output.nc 
```

After the processing, the NetCDF file `output.nc` is produced. Use [Panoply](https://www.giss.nasa.gov/tools/panoply/) to inspect the reconstructed surface.


## Acknowledgements

The study was partially supported by the project of Construction of Ocean Research Stations and their Application Studies funded by the Ministry of Oceans and Fisheries, Republic of Korea.


## License

```
Copyright (C) 2020-2023 Filippo Bergamasco 

WASSfast 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.

WASSfast 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 <http://www.gnu.org/licenses/>.
```

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "wassfast",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": null,
    "keywords": "WASS, 3D, Sea-waves",
    "author": "Filippo Bergamasco",
    "author_email": "filippo.bergamasco@unive.it",
    "download_url": "https://files.pythonhosted.org/packages/5a/fd/af61c90f4805ffd9ec679026270d2217a4eb1573554ab0934dd527e50eea/wassfast-1.5.6.tar.gz",
    "platform": null,
    "description": "WASSfast is the next-generation stereo processing pipeline for sea waves 3D reconstruction. It exploits the linear dispertion relation and sparse feature triangulation to resolve sea-surface elevation in quasi real-time. At present state, WASSfast can work in two operating modes:\n\n1) Predict-Update (PU) mode. See the [paper](https://www.sciencedirect.com/science/article/pii/S0098300420306385)\n\n2) Convolutional Neural Network (CNN) mode (suggested). See the [paper](https://www.mdpi.com/2072-4292/13/18/3780/pdf)\n\n\nFor the standard pipeline see [http://www.dais.unive.it/wass](http://www.dais.unive.it/wass)\n\n**Note** Due to TensorFlow version incompatibilities, WASSfast installed via Pypi supports CNN mode only.\n\n## How to use it\n\nInstall via pip:\n\n```\npython -m pip install wassfast\n```\n\nand run `wassfast --help` for a brief description of the command-line options.\n\n\n## Try it with test data\n\n1. Download the [test data](https://www.dais.unive.it/wass/wassfast_testdata_256.7z)\n2. Extract the test data ```7z x wassfast_testdata_256.7z```. This will create\n   a directory named `wassfast_testdata_256`\n3. Enter the newly extracted directory: `cd wassfast_testdata_256`\n4. Execute WASSfast:\n\n```\nwassfast ./input ./config256.mat ./config ./settings.cfg RLTB CNN --batchsize 16 -n 49 -r 15.0 -o output.nc \n```\n\nAfter the processing, the NetCDF file `output.nc` is produced. Use [Panoply](https://www.giss.nasa.gov/tools/panoply/) to inspect the reconstructed surface.\n\n\n## Acknowledgements\n\nThe study was partially supported by the project of Construction of Ocean Research Stations and their Application Studies funded by the Ministry of Oceans and Fisheries, Republic of Korea.\n\n\n## License\n\n```\nCopyright (C) 2020-2023 Filippo Bergamasco \n\nWASSfast is free software: you can redistribute it and/or modify\nit under the terms of the GNU General Public License as published by\nthe Free Software Foundation, either version 3 of the License, or\n(at your option) any later version.\n\nWASSfast is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\nGNU General Public License for more details.\n\nYou should have received a copy of the GNU General Public License\nalong with this program.  If not, see <http://www.gnu.org/licenses/>.\n```\n",
    "bugtrack_url": null,
    "license": "GPL3",
    "summary": "The next-generation stereo processing pipeline for sea waves 3D reconstruction.",
    "version": "1.5.6",
    "project_urls": {
        "homepage": "https://sites.google.com/unive.it/wass",
        "repository": "https://gitlab.com/fibe/wassfast"
    },
    "split_keywords": [
        "wass",
        " 3d",
        " sea-waves"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "d965b880438e51187dce589c936069e4702ee775f01f0b41783a23d9ad9f8df4",
                "md5": "0c773ce83fb1256fc7f211be6c466e9c",
                "sha256": "58f0fd61f393f4909b05dbcbd722bec610f6724d8f7111d8fcfa5f8a2b96d447"
            },
            "downloads": -1,
            "filename": "wassfast-1.5.6-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "0c773ce83fb1256fc7f211be6c466e9c",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 21818414,
            "upload_time": "2025-01-08T11:11:32",
            "upload_time_iso_8601": "2025-01-08T11:11:32.368544Z",
            "url": "https://files.pythonhosted.org/packages/d9/65/b880438e51187dce589c936069e4702ee775f01f0b41783a23d9ad9f8df4/wassfast-1.5.6-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "5afdaf61c90f4805ffd9ec679026270d2217a4eb1573554ab0934dd527e50eea",
                "md5": "c6e91ca95084eb8904f4a5f6e113c5c7",
                "sha256": "8874975842dce27cde1ec7aad8b088e943da5fab117e60caea16771c8bc48b20"
            },
            "downloads": -1,
            "filename": "wassfast-1.5.6.tar.gz",
            "has_sig": false,
            "md5_digest": "c6e91ca95084eb8904f4a5f6e113c5c7",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 25798285,
            "upload_time": "2025-01-08T11:11:37",
            "upload_time_iso_8601": "2025-01-08T11:11:37.255716Z",
            "url": "https://files.pythonhosted.org/packages/5a/fd/af61c90f4805ffd9ec679026270d2217a4eb1573554ab0934dd527e50eea/wassfast-1.5.6.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-01-08 11:11:37",
    "github": false,
    "gitlab": true,
    "bitbucket": false,
    "codeberg": false,
    "gitlab_user": "fibe",
    "gitlab_project": "wassfast",
    "lcname": "wassfast"
}
        
Elapsed time: 4.83814s