# FREESIF
Work easily with data from SESAM Interface Files.
## General
### About
Python package that enables easy extraction of data from SESAM Interface Files.
The following file formats are currently supported:
- Formatted finite element model file (.FEM)
- Formatted interface file (.SIF)
- Unformatted interface file (.SIU)
### Getting started
Install the latest release
```console
pip install freesif
```
... and import it into a script
```python
from freesif import open_sif
```
### Resources
* [**Source**](https://github.com/agrav/freesif)
* [**Issues**](https://github.com/agrav/freesif/issues)
* [**Changelog**](https://github.com/agrav/freesif/releases)
* [**Documentation**](https://github.com/agrav/freesif/blob/master/README.md)
* [**Download**](https://pypi.org/project/freesif/)
## Contribute
These instructions will get you a copy of the project up and running on your local machine for development and testing
purposes. See deployment for notes on how to deploy the project on a live system.
### Prerequisites
Install Python version 3.6 or later from either https://www.python.org or https://www.anaconda.com.
### Clone the source code repository
At the desired location, run:
```git clone https://github.com/agrav/freesif.git```
### Installing
To get the development environment running:
... create an isolated Python environment and activate it,
```console
python -m venv /path/to/new/virtual/environment
/path/to/new/virtual/environment/Scripts/activate
```
... install the dev dependencies in [requirements.txt](requirements.txt),
```console
pip install -r requirements.txt
```
.. and install the package in development mode.
```console
python setup.py develop
```
You should now be able to import the package in the Python console,
```python
import freesif
help(freesif)
```
### Running the tests
The unit tests are automated using the `unittest` and `pytest` framework. Run the test by...
```console
pytest --cov=freesif --cov-report term-missing tests/
```
### Building the package
Build tarball and wheel distributions by:
```console
pip install wheel
python setup.py sdist bdist_wheel
```
The distribution file names adhere to the [PEP 0427](https://www.python.org/dev/peps/pep-0427/#file-name-convention)
convention `{distribution}-{version}(-{build tag})?-{python tag}-{abi tag}-{platform tag}.whl`.
<!---
### Building the documentation
The html documentation is build using [Sphinx](http://www.sphinx-doc.org/en/master)
```console
sphinx-build -b html docs\source docs\_build
```
--->
### Deployment
Packaging, unit testing and deployment to [PyPi](https://pypi.org) is automated using GitHub Actions.
### Versioning
We apply the "major.minor.micro" versioning scheme defined in [PEP 440](https://www.python.org/dev/peps/pep-0440/).
Cut a new version by applying a Git tag like `1.0.1` at the desired commit and then
[setuptools_scm](https://github.com/pypa/setuptools_scm/#setup-py-usage) takes care of the rest. For the versions
available, see the [tags on this repository](https://github.com/agrav/freesif/tags).
## Authors
* **Audun Gravdal Johansen** - [agrav](https://github.com/agrav)
## Maintainers
* **Audun Gravdal Johansen** - [agrav](https://github.com/agrav)
* **Per Voie** - [tovop](https://github.com/tovop)
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
Raw data
{
"_id": null,
"home_page": "https://github.com/agrav/freesif",
"name": "freesif",
"maintainer": "",
"docs_url": null,
"requires_python": "~=3.7",
"maintainer_email": "",
"keywords": "sesam structural hydrodynamic",
"author": "Audun Gravdal Johansen",
"author_email": "audun.gravdal.johansen@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/95/41/379929ab55a236fcc55f03a9f9d089a84da0af2342f19935a2e0cf29f6f4/freesif-0.1.3.tar.gz",
"platform": null,
"description": "# FREESIF\n\nWork easily with data from SESAM Interface Files.\n\n## General\n\n### About\n\nPython package that enables easy extraction of data from SESAM Interface Files.\n\nThe following file formats are currently supported:\n\n- Formatted finite element model file (.FEM)\n- Formatted interface file (.SIF)\n- Unformatted interface file (.SIU)\n\n### Getting started\n\nInstall the latest release\n\n```console\npip install freesif\n```\n\n... and import it into a script\n\n```python\nfrom freesif import open_sif\n```\n\n### Resources\n\n* [**Source**](https://github.com/agrav/freesif)\n* [**Issues**](https://github.com/agrav/freesif/issues)\n* [**Changelog**](https://github.com/agrav/freesif/releases)\n* [**Documentation**](https://github.com/agrav/freesif/blob/master/README.md)\n* [**Download**](https://pypi.org/project/freesif/)\n\n## Contribute\n\nThese instructions will get you a copy of the project up and running on your local machine for development and testing\npurposes. See deployment for notes on how to deploy the project on a live system.\n\n### Prerequisites\n\nInstall Python version 3.6 or later from either https://www.python.org or https://www.anaconda.com.\n\n### Clone the source code repository\n\nAt the desired location, run:\n\n```git clone https://github.com/agrav/freesif.git```\n\n### Installing\n\nTo get the development environment running:\n\n... create an isolated Python environment and activate it,\n\n```console\npython -m venv /path/to/new/virtual/environment\n\n/path/to/new/virtual/environment/Scripts/activate\n```\n\n... install the dev dependencies in [requirements.txt](requirements.txt),\n\n```console\npip install -r requirements.txt\n```\n\n.. and install the package in development mode.\n\n```console\npython setup.py develop\n```\n\nYou should now be able to import the package in the Python console,\n\n```python\nimport freesif\nhelp(freesif)\n```\n\n### Running the tests\n\nThe unit tests are automated using the `unittest` and `pytest` framework. Run the test by...\n\n```console\npytest --cov=freesif --cov-report term-missing tests/\n```\n\n### Building the package\n\nBuild tarball and wheel distributions by:\n\n```console\npip install wheel\npython setup.py sdist bdist_wheel\n```\n\nThe distribution file names adhere to the [PEP 0427](https://www.python.org/dev/peps/pep-0427/#file-name-convention)\nconvention `{distribution}-{version}(-{build tag})?-{python tag}-{abi tag}-{platform tag}.whl`.\n\n<!---\n### Building the documentation\n\nThe html documentation is build using [Sphinx](http://www.sphinx-doc.org/en/master)\n\n```console\nsphinx-build -b html docs\\source docs\\_build\n```\n--->\n\n### Deployment\nPackaging, unit testing and deployment to [PyPi](https://pypi.org) is automated using GitHub Actions.\n\n### Versioning\n\nWe apply the \"major.minor.micro\" versioning scheme defined in [PEP 440](https://www.python.org/dev/peps/pep-0440/).\n\nCut a new version by applying a Git tag like `1.0.1` at the desired commit and then\n[setuptools_scm](https://github.com/pypa/setuptools_scm/#setup-py-usage) takes care of the rest. For the versions\navailable, see the [tags on this repository](https://github.com/agrav/freesif/tags).\n\n## Authors\n\n* **Audun Gravdal Johansen** - [agrav](https://github.com/agrav)\n\n## Maintainers\n\n* **Audun Gravdal Johansen** - [agrav](https://github.com/agrav)\n* **Per Voie** - [tovop](https://github.com/tovop)\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Get data from Sesam Interface Files",
"version": "0.1.3",
"project_urls": {
"Homepage": "https://github.com/agrav/freesif"
},
"split_keywords": [
"sesam",
"structural",
"hydrodynamic"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "093a94548a91fa7d0a5fb302d1fb1624621ed9bab971ee900a7fd92561fd096f",
"md5": "360fa2ba2ecddef12c4379f66bd98df2",
"sha256": "4a4304a64c4f52e624cf25f30a9ddcd3926a7cdf6fa4db7853741a0d50a972a3"
},
"downloads": -1,
"filename": "freesif-0.1.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "360fa2ba2ecddef12c4379f66bd98df2",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "~=3.7",
"size": 52385,
"upload_time": "2023-09-21T11:01:12",
"upload_time_iso_8601": "2023-09-21T11:01:12.721258Z",
"url": "https://files.pythonhosted.org/packages/09/3a/94548a91fa7d0a5fb302d1fb1624621ed9bab971ee900a7fd92561fd096f/freesif-0.1.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9541379929ab55a236fcc55f03a9f9d089a84da0af2342f19935a2e0cf29f6f4",
"md5": "273e191c3af1b61b8be7e9de201ca372",
"sha256": "6479a6246548a9c17c4d03532084bb1eb0adcf2978afd90a9dcdeabfba67feaa"
},
"downloads": -1,
"filename": "freesif-0.1.3.tar.gz",
"has_sig": false,
"md5_digest": "273e191c3af1b61b8be7e9de201ca372",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "~=3.7",
"size": 27477554,
"upload_time": "2023-09-21T11:01:15",
"upload_time_iso_8601": "2023-09-21T11:01:15.196000Z",
"url": "https://files.pythonhosted.org/packages/95/41/379929ab55a236fcc55f03a9f9d089a84da0af2342f19935a2e0cf29f6f4/freesif-0.1.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-21 11:01:15",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "agrav",
"github_project": "freesif",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "numpy",
"specs": [
[
"==",
"1.18.4"
]
]
},
{
"name": "tables",
"specs": [
[
"==",
"3.6.1"
]
]
},
{
"name": "h5py",
"specs": [
[
"==",
"2.10.0"
]
]
},
{
"name": "pytest-cov",
"specs": [
[
"==",
"2.8.1"
]
]
}
],
"lcname": "freesif"
}
JSON
