cfd-ops 0.1.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,54 @@
1
+ # BSD-3-Clause License - see LICENSE file
2
+ name: Documentation
3
+
4
+ on:
5
+ push:
6
+ branches: [main]
7
+ pull_request:
8
+ branches: [main]
9
+ workflow_dispatch:
10
+
11
+ permissions:
12
+ contents: read
13
+ pages: write
14
+ id-token: write
15
+
16
+ concurrency:
17
+ group: "pages"
18
+ cancel-in-progress: false
19
+
20
+ jobs:
21
+ build:
22
+ runs-on: ubuntu-latest
23
+ steps:
24
+ - uses: actions/checkout@v4
25
+
26
+ - name: Set up Python
27
+ uses: actions/setup-python@v5
28
+ with:
29
+ python-version: "3.11"
30
+
31
+ - name: Install dependencies
32
+ run: |
33
+ pip install "mkdocs>=1.5,<2" mkdocs-material mkdocstrings[python]
34
+ pip install -e .
35
+
36
+ - name: Build documentation
37
+ run: mkdocs build --strict
38
+
39
+ - name: Upload artifact
40
+ uses: actions/upload-pages-artifact@v3
41
+ with:
42
+ path: site
43
+
44
+ deploy:
45
+ if: github.ref == 'refs/heads/main'
46
+ needs: build
47
+ runs-on: ubuntu-latest
48
+ environment:
49
+ name: github-pages
50
+ url: ${{ steps.deployment.outputs.page_url }}
51
+ steps:
52
+ - name: Deploy to GitHub Pages
53
+ id: deployment
54
+ uses: actions/deploy-pages@v4
@@ -0,0 +1,81 @@
1
+ name: Publish to PyPI
2
+
3
+ on:
4
+ push:
5
+ tags:
6
+ - "v*"
7
+
8
+ jobs:
9
+ test:
10
+ runs-on: ubuntu-latest
11
+ strategy:
12
+ matrix:
13
+ python-version: ["3.11", "3.12", "3.13"]
14
+ steps:
15
+ - uses: actions/checkout@v4
16
+
17
+ - name: Set up Python ${{ matrix.python-version }}
18
+ uses: actions/setup-python@v5
19
+ with:
20
+ python-version: ${{ matrix.python-version }}
21
+
22
+ - name: Install package
23
+ run: pip install -e ".[dev]"
24
+
25
+ - name: Lint with ruff
26
+ run: ruff check src/
27
+
28
+ - name: Run tests
29
+ run: pytest
30
+
31
+ build:
32
+ needs: test
33
+ runs-on: ubuntu-latest
34
+ steps:
35
+ - uses: actions/checkout@v4
36
+
37
+ - name: Set up Python
38
+ uses: actions/setup-python@v5
39
+ with:
40
+ python-version: "3.11"
41
+
42
+ - name: Install build tools
43
+ run: pip install build
44
+
45
+ - name: Build package
46
+ run: python -m build
47
+
48
+ - name: Upload dist artifacts
49
+ uses: actions/upload-artifact@v4
50
+ with:
51
+ name: dist
52
+ path: dist/
53
+
54
+ publish:
55
+ needs: build
56
+ runs-on: ubuntu-latest
57
+ environment: pypi
58
+ permissions:
59
+ id-token: write
60
+
61
+ steps:
62
+ - name: Download dist artifacts
63
+ uses: actions/download-artifact@v4
64
+ with:
65
+ name: dist
66
+ path: dist/
67
+
68
+ - name: Publish to PyPI
69
+ uses: pypa/gh-action-pypi-publish@release/v1
70
+
71
+ release:
72
+ needs: publish
73
+ runs-on: ubuntu-latest
74
+ permissions:
75
+ contents: write
76
+ steps:
77
+ - uses: actions/checkout@v4
78
+ - name: Create GitHub Release
79
+ run: gh release create "${{ github.ref_name }}" --generate-notes
80
+ env:
81
+ GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -0,0 +1,41 @@
1
+ # BSD-3-Clause License - see LICENSE file
2
+ name: Test
3
+
4
+ on:
5
+ push:
6
+ branches: [main]
7
+ pull_request:
8
+ branches: [main]
9
+
10
+ jobs:
11
+ test:
12
+ runs-on: ubuntu-latest
13
+ strategy:
14
+ matrix:
15
+ python-version: ["3.11", "3.12", "3.13"]
16
+
17
+ steps:
18
+ - uses: actions/checkout@v4
19
+
20
+ - name: Set up Python ${{ matrix.python-version }}
21
+ uses: actions/setup-python@v5
22
+ with:
23
+ python-version: ${{ matrix.python-version }}
24
+
25
+ - name: Install package
26
+ run: pip install -e ".[dev]"
27
+
28
+ - name: Lint with ruff
29
+ run: ruff check src/
30
+
31
+ - name: Run tests with coverage
32
+ run: pytest --cov=cfd_ops --cov-report=xml -q
33
+
34
+ - name: Upload coverage to Codecov
35
+ if: matrix.python-version == '3.13'
36
+ uses: codecov/codecov-action@v5
37
+ with:
38
+ files: coverage.xml
39
+ token: "${{ secrets.CODECOV_TOKEN }}"
40
+ slug: uahypersonics/cfd-ops
41
+ fail_ci_if_error: false
@@ -0,0 +1,207 @@
1
+ # Byte-compiled / optimized / DLL files
2
+ __pycache__/
3
+ *.py[codz]
4
+ *$py.class
5
+
6
+ # C extensions
7
+ *.so
8
+
9
+ # Distribution / packaging
10
+ .Python
11
+ build/
12
+ develop-eggs/
13
+ dist/
14
+ downloads/
15
+ eggs/
16
+ .eggs/
17
+ lib/
18
+ lib64/
19
+ parts/
20
+ sdist/
21
+ var/
22
+ wheels/
23
+ share/python-wheels/
24
+ *.egg-info/
25
+ .installed.cfg
26
+ *.egg
27
+ MANIFEST
28
+
29
+ # PyInstaller
30
+ # Usually these files are written by a python script from a template
31
+ # before PyInstaller builds the exe, so as to inject date/other infos into it.
32
+ *.manifest
33
+ *.spec
34
+
35
+ # Installer logs
36
+ pip-log.txt
37
+ pip-delete-this-directory.txt
38
+
39
+ # Unit test / coverage reports
40
+ htmlcov/
41
+ .tox/
42
+ .nox/
43
+ .coverage
44
+ .coverage.*
45
+ .cache
46
+ nosetests.xml
47
+ coverage.xml
48
+ *.cover
49
+ *.py.cover
50
+ .hypothesis/
51
+ .pytest_cache/
52
+ cover/
53
+
54
+ # Translations
55
+ *.mo
56
+ *.pot
57
+
58
+ # Django stuff:
59
+ *.log
60
+ local_settings.py
61
+ db.sqlite3
62
+ db.sqlite3-journal
63
+
64
+ # Flask stuff:
65
+ instance/
66
+ .webassets-cache
67
+
68
+ # Scrapy stuff:
69
+ .scrapy
70
+
71
+ # Sphinx documentation
72
+ docs/_build/
73
+
74
+ # PyBuilder
75
+ .pybuilder/
76
+ target/
77
+
78
+ # Jupyter Notebook
79
+ .ipynb_checkpoints
80
+
81
+ # IPython
82
+ profile_default/
83
+ ipython_config.py
84
+
85
+ # pyenv
86
+ # For a library or package, you might want to ignore these files since the code is
87
+ # intended to run in multiple environments; otherwise, check them in:
88
+ # .python-version
89
+
90
+ # pipenv
91
+ # According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
92
+ # However, in case of collaboration, if having platform-specific dependencies or dependencies
93
+ # having no cross-platform support, pipenv may install dependencies that don't work, or not
94
+ # install all needed dependencies.
95
+ #Pipfile.lock
96
+
97
+ # UV
98
+ # Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
99
+ # This is especially recommended for binary packages to ensure reproducibility, and is more
100
+ # commonly ignored for libraries.
101
+ #uv.lock
102
+
103
+ # poetry
104
+ # Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
105
+ # This is especially recommended for binary packages to ensure reproducibility, and is more
106
+ # commonly ignored for libraries.
107
+ # https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
108
+ #poetry.lock
109
+ #poetry.toml
110
+
111
+ # pdm
112
+ # Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
113
+ # pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
114
+ # https://pdm-project.org/en/latest/usage/project/#working-with-version-control
115
+ #pdm.lock
116
+ #pdm.toml
117
+ .pdm-python
118
+ .pdm-build/
119
+
120
+ # pixi
121
+ # Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
122
+ #pixi.lock
123
+ # Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
124
+ # in the .venv directory. It is recommended not to include this directory in version control.
125
+ .pixi
126
+
127
+ # PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
128
+ __pypackages__/
129
+
130
+ # Celery stuff
131
+ celerybeat-schedule
132
+ celerybeat.pid
133
+
134
+ # SageMath parsed files
135
+ *.sage.py
136
+
137
+ # Environments
138
+ .env
139
+ .envrc
140
+ .venv
141
+ env/
142
+ venv/
143
+ ENV/
144
+ env.bak/
145
+ venv.bak/
146
+
147
+ # Spyder project settings
148
+ .spyderproject
149
+ .spyproject
150
+
151
+ # Rope project settings
152
+ .ropeproject
153
+
154
+ # mkdocs documentation
155
+ /site
156
+
157
+ # mypy
158
+ .mypy_cache/
159
+ .dmypy.json
160
+ dmypy.json
161
+
162
+ # Pyre type checker
163
+ .pyre/
164
+
165
+ # pytype static type analyzer
166
+ .pytype/
167
+
168
+ # Cython debug symbols
169
+ cython_debug/
170
+
171
+ # PyCharm
172
+ # JetBrains specific template is maintained in a separate JetBrains.gitignore that can
173
+ # be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
174
+ # and can be added to the global gitignore or merged into this file. For a more nuclear
175
+ # option (not recommended) you can uncomment the following to ignore the entire idea folder.
176
+ #.idea/
177
+
178
+ # Abstra
179
+ # Abstra is an AI-powered process automation framework.
180
+ # Ignore directories containing user credentials, local state, and settings.
181
+ # Learn more at https://abstra.io/docs
182
+ .abstra/
183
+
184
+ # Visual Studio Code
185
+ # Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore
186
+ # that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
187
+ # and can be added to the global gitignore or merged into this file. However, if you prefer,
188
+ # you could uncomment the following to ignore the entire vscode folder
189
+ # .vscode/
190
+
191
+ # Ruff stuff:
192
+ .ruff_cache/
193
+
194
+ # PyPI configuration file
195
+ .pypirc
196
+
197
+ # Cursor
198
+ # Cursor is an AI-powered code editor. `.cursorignore` specifies files/directories to
199
+ # exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
200
+ # refer to https://docs.cursor.com/context/ignore-files
201
+ .cursorignore
202
+ .cursorindexingignore
203
+
204
+ # Marimo
205
+ marimo/_static/
206
+ marimo/_lsp/
207
+ __marimo__/
@@ -0,0 +1,19 @@
1
+ cff-version: 1.2.0
2
+ message: "If you use this software, please cite it as below."
3
+ title: "cfd-ops"
4
+ abstract: "Operations for transforming, extracting, remapping, and combining CFD datasets"
5
+ type: software
6
+ authors:
7
+ - family-names: "Hader"
8
+ given-names: "Christoph"
9
+ affiliation: "University of Arizona"
10
+ orcid: "https://orcid.org/0000-0002-0956-000X"
11
+ repository-code: "https://github.com/uahypersonics/cfd-ops"
12
+ url: "https://uahypersonics.github.io/cfd-ops"
13
+ license: BSD-3-Clause
14
+ keywords:
15
+ - computational fluid dynamics
16
+ - dataset operations
17
+ - transform
18
+ - extract
19
+ - remap
cfd_ops-0.1.0/LICENSE ADDED
@@ -0,0 +1,28 @@
1
+ BSD 3-Clause License
2
+
3
+ Copyright (c) 2026, uahypersonics
4
+
5
+ Redistribution and use in source and binary forms, with or without
6
+ modification, are permitted provided that the following conditions are met:
7
+
8
+ 1. Redistributions of source code must retain the above copyright notice, this
9
+ list of conditions and the following disclaimer.
10
+
11
+ 2. Redistributions in binary form must reproduce the above copyright notice,
12
+ this list of conditions and the following disclaimer in the documentation
13
+ and/or other materials provided with the distribution.
14
+
15
+ 3. Neither the name of the copyright holder nor the names of its
16
+ contributors may be used to endorse or promote products derived from
17
+ this software without specific prior written permission.
18
+
19
+ THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
20
+ AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21
+ IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
22
+ DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
23
+ FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
24
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
25
+ SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
26
+ CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
27
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
28
+ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
cfd_ops-0.1.0/PKG-INFO ADDED
@@ -0,0 +1,100 @@
1
+ Metadata-Version: 2.4
2
+ Name: cfd-ops
3
+ Version: 0.1.0
4
+ Summary: Operations for transforming, extracting, remapping, and combining CFD datasets built on the cfd-io data model
5
+ Author-email: Christoph Hader <chader@arizona.edu>
6
+ License: BSD-3-Clause
7
+ Project-URL: Homepage, https://github.com/uahypersonics/cfd-ops
8
+ Project-URL: Repository, https://github.com/uahypersonics/cfd-ops
9
+ Keywords: cfd,operations,transform,extract,remap,dataset
10
+ Classifier: Development Status :: 3 - Alpha
11
+ Classifier: Intended Audience :: Science/Research
12
+ Classifier: License :: OSI Approved :: BSD License
13
+ Classifier: Programming Language :: Python :: 3
14
+ Classifier: Programming Language :: Python :: 3.11
15
+ Classifier: Programming Language :: Python :: 3.12
16
+ Classifier: Programming Language :: Python :: 3.13
17
+ Classifier: Topic :: Scientific/Engineering :: Physics
18
+ Requires-Python: >=3.11
19
+ Description-Content-Type: text/markdown
20
+ License-File: LICENSE
21
+ Requires-Dist: numpy>=1.24.0
22
+ Requires-Dist: cfd-io>=0.2.0
23
+ Provides-Extra: dev
24
+ Requires-Dist: pytest>=7.0; extra == "dev"
25
+ Requires-Dist: pytest-cov>=4.0; extra == "dev"
26
+ Requires-Dist: ruff>=0.1.0; extra == "dev"
27
+ Provides-Extra: docs
28
+ Requires-Dist: mkdocs<2,>=1.5; extra == "docs"
29
+ Requires-Dist: mkdocs-material>=9.0; extra == "docs"
30
+ Requires-Dist: mkdocstrings[python]>=0.24; extra == "docs"
31
+ Dynamic: license-file
32
+
33
+ # cfd-ops
34
+
35
+ Operations for transforming, extracting, remapping, and combining CFD datasets
36
+ built on the [cfd-io](https://github.com/uahypersonics/cfd-io) data model.
37
+
38
+ [![Test](https://github.com/uahypersonics/cfd-ops/actions/workflows/test.yml/badge.svg)](https://github.com/uahypersonics/cfd-ops/actions/workflows/test.yml)
39
+ [![PyPI](https://img.shields.io/pypi/v/cfd-ops)](https://pypi.org/project/cfd-ops/)
40
+ [![Docs](https://img.shields.io/badge/docs-mkdocs-blue)](https://uahypersonics.github.io/cfd-ops/)
41
+ [![License](https://img.shields.io/badge/License-BSD_3--Clause-blue.svg)](LICENSE)
42
+ [![Python](https://img.shields.io/badge/python-≥3.11-blue.svg)](https://www.python.org/downloads/)
43
+ [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
44
+
45
+ ## Install
46
+
47
+ ```bash
48
+ pip install cfd-ops
49
+ ```
50
+
51
+ ## Documentation
52
+
53
+ Full documentation: https://uahypersonics.github.io/cfd-ops
54
+
55
+ ## Citation
56
+
57
+ If `cfd-ops` contributes to published work, please cite via the `CITATION.cff` in this repository.
58
+
59
+ ## Code Style
60
+
61
+ This project follows established Python community conventions so that
62
+ contributors can focus on the physics rather than inventing formatting rules.
63
+
64
+ | Convention | What it covers | Reference |
65
+ |---|---|---|
66
+ | [PEP 8](https://peps.python.org/pep-0008/) | Code formatting, naming, whitespace | Python standard style guide |
67
+ | [PEP 257](https://peps.python.org/pep-0257/) | Docstring structure (triple-quoted, imperative mood) | Python standard docstring conventions |
68
+ | [Google style](https://google.github.io/styleguide/pyguide.html#38-comments-and-docstrings) | Docstring sections (`Args`, `Returns`, `Raises`) | Google Python style guide |
69
+ | [Ruff](https://docs.astral.sh/ruff/) | Automated linting and formatting | Enforces PEP 8 compliance automatically |
70
+ | [typing / TYPE_CHECKING](https://docs.python.org/3/library/typing.html#typing.TYPE_CHECKING) | Type hints for IDE support and static analysis | Python standard library |
71
+
72
+ ## Versioning & Releasing
73
+
74
+ This project uses [Semantic Versioning](https://semver.org/) (`vMAJOR.MINOR.PATCH`):
75
+
76
+ - **MAJOR** (`v1.0.0`, `v2.0.0`): Breaking API changes
77
+ - **MINOR** (`v0.3.0`, `v0.4.0`): New features, backward-compatible
78
+ - **PATCH** (`v0.3.1`, `v0.3.2`): Bug fixes, minor corrections
79
+
80
+ To publish a new version to [PyPI](https://pypi.org/project/cfd-ops/):
81
+
82
+ 1. Commit and push to `main`
83
+ 2. Tag and push:
84
+ ```bash
85
+ git tag -a vMAJOR.MINOR.PATCH -m "Release vMAJOR.MINOR.PATCH"
86
+ git push origin vMAJOR.MINOR.PATCH
87
+ ```
88
+
89
+ Use a signed tag when your GPG/SSH signing is configured:
90
+
91
+ ```bash
92
+ git tag -s vMAJOR.MINOR.PATCH -m "Release vMAJOR.MINOR.PATCH"
93
+ git push origin vMAJOR.MINOR.PATCH
94
+ ```
95
+
96
+ The GitHub Actions workflow will automatically build and publish to PyPI via Trusted Publishing.
97
+
98
+ ## License
99
+
100
+ BSD-3-Clause. See [LICENSE](LICENSE) for details.
@@ -0,0 +1,68 @@
1
+ # cfd-ops
2
+
3
+ Operations for transforming, extracting, remapping, and combining CFD datasets
4
+ built on the [cfd-io](https://github.com/uahypersonics/cfd-io) data model.
5
+
6
+ [![Test](https://github.com/uahypersonics/cfd-ops/actions/workflows/test.yml/badge.svg)](https://github.com/uahypersonics/cfd-ops/actions/workflows/test.yml)
7
+ [![PyPI](https://img.shields.io/pypi/v/cfd-ops)](https://pypi.org/project/cfd-ops/)
8
+ [![Docs](https://img.shields.io/badge/docs-mkdocs-blue)](https://uahypersonics.github.io/cfd-ops/)
9
+ [![License](https://img.shields.io/badge/License-BSD_3--Clause-blue.svg)](LICENSE)
10
+ [![Python](https://img.shields.io/badge/python-≥3.11-blue.svg)](https://www.python.org/downloads/)
11
+ [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
12
+
13
+ ## Install
14
+
15
+ ```bash
16
+ pip install cfd-ops
17
+ ```
18
+
19
+ ## Documentation
20
+
21
+ Full documentation: https://uahypersonics.github.io/cfd-ops
22
+
23
+ ## Citation
24
+
25
+ If `cfd-ops` contributes to published work, please cite via the `CITATION.cff` in this repository.
26
+
27
+ ## Code Style
28
+
29
+ This project follows established Python community conventions so that
30
+ contributors can focus on the physics rather than inventing formatting rules.
31
+
32
+ | Convention | What it covers | Reference |
33
+ |---|---|---|
34
+ | [PEP 8](https://peps.python.org/pep-0008/) | Code formatting, naming, whitespace | Python standard style guide |
35
+ | [PEP 257](https://peps.python.org/pep-0257/) | Docstring structure (triple-quoted, imperative mood) | Python standard docstring conventions |
36
+ | [Google style](https://google.github.io/styleguide/pyguide.html#38-comments-and-docstrings) | Docstring sections (`Args`, `Returns`, `Raises`) | Google Python style guide |
37
+ | [Ruff](https://docs.astral.sh/ruff/) | Automated linting and formatting | Enforces PEP 8 compliance automatically |
38
+ | [typing / TYPE_CHECKING](https://docs.python.org/3/library/typing.html#typing.TYPE_CHECKING) | Type hints for IDE support and static analysis | Python standard library |
39
+
40
+ ## Versioning & Releasing
41
+
42
+ This project uses [Semantic Versioning](https://semver.org/) (`vMAJOR.MINOR.PATCH`):
43
+
44
+ - **MAJOR** (`v1.0.0`, `v2.0.0`): Breaking API changes
45
+ - **MINOR** (`v0.3.0`, `v0.4.0`): New features, backward-compatible
46
+ - **PATCH** (`v0.3.1`, `v0.3.2`): Bug fixes, minor corrections
47
+
48
+ To publish a new version to [PyPI](https://pypi.org/project/cfd-ops/):
49
+
50
+ 1. Commit and push to `main`
51
+ 2. Tag and push:
52
+ ```bash
53
+ git tag -a vMAJOR.MINOR.PATCH -m "Release vMAJOR.MINOR.PATCH"
54
+ git push origin vMAJOR.MINOR.PATCH
55
+ ```
56
+
57
+ Use a signed tag when your GPG/SSH signing is configured:
58
+
59
+ ```bash
60
+ git tag -s vMAJOR.MINOR.PATCH -m "Release vMAJOR.MINOR.PATCH"
61
+ git push origin vMAJOR.MINOR.PATCH
62
+ ```
63
+
64
+ The GitHub Actions workflow will automatically build and publish to PyPI via Trusted Publishing.
65
+
66
+ ## License
67
+
68
+ BSD-3-Clause. See [LICENSE](LICENSE) for details.
@@ -0,0 +1,3 @@
1
+ # API Reference
2
+
3
+ Technical reference for the `cfd_ops` package.
@@ -0,0 +1,13 @@
1
+ # cfd-ops
2
+
3
+ Operations for transforming, extracting, remapping, and combining CFD datasets
4
+ built on the [cfd-io](https://github.com/uahypersonics/cfd-io) data model.
5
+
6
+ ## Quick Start
7
+
8
+ ```python
9
+ from cfd_ops import ... # coming soon
10
+ ```
11
+
12
+ See the [Installation](installation.md) guide to get started, or the
13
+ [API Reference](api/index.md) for full technical details.
@@ -0,0 +1,19 @@
1
+ # Installation
2
+
3
+ ## Requirements
4
+
5
+ - Python 3.11 or later
6
+
7
+ ## From Source
8
+
9
+ ```bash
10
+ git clone https://github.com/uahypersonics/cfd-ops.git
11
+ cd cfd-ops
12
+ pip install -e .
13
+ ```
14
+
15
+ ## Development Installation
16
+
17
+ ```bash
18
+ pip install -e ".[dev]"
19
+ ```
@@ -0,0 +1,97 @@
1
+ # BSD-3-Clause License - see LICENSE file
2
+
3
+ # --------------------------------------------------
4
+ # site metadata
5
+ # --------------------------------------------------
6
+ site_name: cfd-ops
7
+ site_url: https://uahypersonics.github.io/cfd-ops
8
+ site_author: Christoph Hader
9
+ site_description: Operations for transforming, extracting, remapping, and combining CFD datasets.
10
+
11
+ # --------------------------------------------------
12
+ # github repository (adds link in top right corner)
13
+ # --------------------------------------------------
14
+ repo_name: uahypersonics/cfd-ops
15
+ repo_url: https://github.com/uahypersonics/cfd-ops
16
+ edit_uri: edit/main/docs/
17
+
18
+ # --------------------------------------------------
19
+ # theme configuration
20
+ # uses Material for MkDocs: https://squidfunk.github.io/mkdocs-material/
21
+ # --------------------------------------------------
22
+ theme:
23
+ name: material
24
+ palette:
25
+ - media: "(prefers-color-scheme)"
26
+ toggle:
27
+ icon: material/brightness-auto
28
+ name: Switch to light mode
29
+ - media: "(prefers-color-scheme: light)"
30
+ scheme: default
31
+ primary: blue grey
32
+ accent: blue grey
33
+ toggle:
34
+ icon: material/weather-sunny
35
+ name: Switch to dark mode
36
+ - media: "(prefers-color-scheme: dark)"
37
+ scheme: slate
38
+ primary: blue grey
39
+ accent: blue grey
40
+ toggle:
41
+ icon: material/weather-night
42
+ name: Switch to system preference
43
+ features:
44
+ - navigation.tabs
45
+ - navigation.sections
46
+ - navigation.indexes
47
+ - navigation.top
48
+ - content.code.copy
49
+ - content.code.annotate
50
+ - content.action.edit
51
+ - content.action.view
52
+
53
+ # --------------------------------------------------
54
+ # plugins
55
+ # --------------------------------------------------
56
+ plugins:
57
+ - search
58
+ - mkdocstrings:
59
+ handlers:
60
+ python:
61
+ paths: [src]
62
+ options:
63
+ show_source: false
64
+ show_root_heading: true
65
+ show_root_full_path: false
66
+ heading_level: 2
67
+ docstring_style: google
68
+ members_order: source
69
+
70
+ # --------------------------------------------------
71
+ # markdown extensions
72
+ # --------------------------------------------------
73
+ markdown_extensions:
74
+ - pymdownx.highlight:
75
+ anchor_linenums: true
76
+ linenums: true
77
+ - pymdownx.superfences:
78
+ custom_fences:
79
+ - name: mermaid
80
+ class: mermaid
81
+ format: !!python/name:pymdownx.superfences.fence_code_format
82
+ - pymdownx.tabbed:
83
+ alternate_style: true
84
+ - admonition
85
+ - pymdownx.details
86
+ - tables
87
+ - attr_list
88
+ - md_in_html
89
+
90
+ # --------------------------------------------------
91
+ # navigation
92
+ # --------------------------------------------------
93
+ nav:
94
+ - Home: index.md
95
+ - Installation: installation.md
96
+ - API Reference:
97
+ - api/index.md
@@ -0,0 +1,79 @@
1
+ [build-system]
2
+ requires = ["setuptools>=61.0", "setuptools-scm>=8", "wheel"]
3
+ build-backend = "setuptools.build_meta"
4
+
5
+ [project]
6
+ name = "cfd-ops"
7
+ dynamic = ["version"]
8
+ description = "Operations for transforming, extracting, remapping, and combining CFD datasets built on the cfd-io data model"
9
+ readme = "README.md"
10
+ license = {text = "BSD-3-Clause"}
11
+ requires-python = ">=3.11"
12
+ authors = [
13
+ {name = "Christoph Hader", email = "chader@arizona.edu"},
14
+ ]
15
+ classifiers = [
16
+ "Development Status :: 3 - Alpha",
17
+ "Intended Audience :: Science/Research",
18
+ "License :: OSI Approved :: BSD License",
19
+ "Programming Language :: Python :: 3",
20
+ "Programming Language :: Python :: 3.11",
21
+ "Programming Language :: Python :: 3.12",
22
+ "Programming Language :: Python :: 3.13",
23
+ "Topic :: Scientific/Engineering :: Physics",
24
+ ]
25
+ keywords = ["cfd", "operations", "transform", "extract", "remap", "dataset"]
26
+
27
+ dependencies = [
28
+ "numpy>=1.24.0",
29
+ "cfd-io>=0.2.0",
30
+ ]
31
+
32
+ [project.optional-dependencies]
33
+ dev = [
34
+ "pytest>=7.0",
35
+ "pytest-cov>=4.0",
36
+ "ruff>=0.1.0",
37
+ ]
38
+ docs = [
39
+ "mkdocs>=1.5,<2",
40
+ "mkdocs-material>=9.0",
41
+ "mkdocstrings[python]>=0.24",
42
+ ]
43
+
44
+ [project.urls]
45
+ Homepage = "https://github.com/uahypersonics/cfd-ops"
46
+ Repository = "https://github.com/uahypersonics/cfd-ops"
47
+
48
+ [tool.setuptools.packages.find]
49
+ where = ["src"]
50
+
51
+ [tool.setuptools_scm]
52
+
53
+ [tool.ruff]
54
+ line-length = 100
55
+ target-version = "py311"
56
+
57
+ [tool.ruff.lint]
58
+ select = ["E", "F", "W", "I", "UP"]
59
+ ignore = ["E501"]
60
+
61
+ # --------------------------------------------------
62
+ # coverage
63
+ # --------------------------------------------------
64
+ [tool.coverage.run]
65
+ source = ["cfd_ops"]
66
+ branch = true
67
+
68
+ [tool.coverage.report]
69
+ show_missing = true
70
+ skip_empty = true
71
+ exclude_lines = [
72
+ "pragma: no cover",
73
+ "if __name__ == .__main__.",
74
+ "if TYPE_CHECKING:",
75
+ ]
76
+
77
+ [tool.pytest.ini_options]
78
+ testpaths = ["tests"]
79
+ addopts = "--strict-markers"
@@ -0,0 +1,4 @@
1
+ [egg_info]
2
+ tag_build =
3
+ tag_date = 0
4
+
@@ -0,0 +1,5 @@
1
+ """cfd-ops: Operations for transforming, extracting, remapping, and combining CFD datasets."""
2
+
3
+ from importlib.metadata import version
4
+
5
+ __version__ = version("cfd-ops")
@@ -0,0 +1,100 @@
1
+ Metadata-Version: 2.4
2
+ Name: cfd-ops
3
+ Version: 0.1.0
4
+ Summary: Operations for transforming, extracting, remapping, and combining CFD datasets built on the cfd-io data model
5
+ Author-email: Christoph Hader <chader@arizona.edu>
6
+ License: BSD-3-Clause
7
+ Project-URL: Homepage, https://github.com/uahypersonics/cfd-ops
8
+ Project-URL: Repository, https://github.com/uahypersonics/cfd-ops
9
+ Keywords: cfd,operations,transform,extract,remap,dataset
10
+ Classifier: Development Status :: 3 - Alpha
11
+ Classifier: Intended Audience :: Science/Research
12
+ Classifier: License :: OSI Approved :: BSD License
13
+ Classifier: Programming Language :: Python :: 3
14
+ Classifier: Programming Language :: Python :: 3.11
15
+ Classifier: Programming Language :: Python :: 3.12
16
+ Classifier: Programming Language :: Python :: 3.13
17
+ Classifier: Topic :: Scientific/Engineering :: Physics
18
+ Requires-Python: >=3.11
19
+ Description-Content-Type: text/markdown
20
+ License-File: LICENSE
21
+ Requires-Dist: numpy>=1.24.0
22
+ Requires-Dist: cfd-io>=0.2.0
23
+ Provides-Extra: dev
24
+ Requires-Dist: pytest>=7.0; extra == "dev"
25
+ Requires-Dist: pytest-cov>=4.0; extra == "dev"
26
+ Requires-Dist: ruff>=0.1.0; extra == "dev"
27
+ Provides-Extra: docs
28
+ Requires-Dist: mkdocs<2,>=1.5; extra == "docs"
29
+ Requires-Dist: mkdocs-material>=9.0; extra == "docs"
30
+ Requires-Dist: mkdocstrings[python]>=0.24; extra == "docs"
31
+ Dynamic: license-file
32
+
33
+ # cfd-ops
34
+
35
+ Operations for transforming, extracting, remapping, and combining CFD datasets
36
+ built on the [cfd-io](https://github.com/uahypersonics/cfd-io) data model.
37
+
38
+ [![Test](https://github.com/uahypersonics/cfd-ops/actions/workflows/test.yml/badge.svg)](https://github.com/uahypersonics/cfd-ops/actions/workflows/test.yml)
39
+ [![PyPI](https://img.shields.io/pypi/v/cfd-ops)](https://pypi.org/project/cfd-ops/)
40
+ [![Docs](https://img.shields.io/badge/docs-mkdocs-blue)](https://uahypersonics.github.io/cfd-ops/)
41
+ [![License](https://img.shields.io/badge/License-BSD_3--Clause-blue.svg)](LICENSE)
42
+ [![Python](https://img.shields.io/badge/python-≥3.11-blue.svg)](https://www.python.org/downloads/)
43
+ [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
44
+
45
+ ## Install
46
+
47
+ ```bash
48
+ pip install cfd-ops
49
+ ```
50
+
51
+ ## Documentation
52
+
53
+ Full documentation: https://uahypersonics.github.io/cfd-ops
54
+
55
+ ## Citation
56
+
57
+ If `cfd-ops` contributes to published work, please cite via the `CITATION.cff` in this repository.
58
+
59
+ ## Code Style
60
+
61
+ This project follows established Python community conventions so that
62
+ contributors can focus on the physics rather than inventing formatting rules.
63
+
64
+ | Convention | What it covers | Reference |
65
+ |---|---|---|
66
+ | [PEP 8](https://peps.python.org/pep-0008/) | Code formatting, naming, whitespace | Python standard style guide |
67
+ | [PEP 257](https://peps.python.org/pep-0257/) | Docstring structure (triple-quoted, imperative mood) | Python standard docstring conventions |
68
+ | [Google style](https://google.github.io/styleguide/pyguide.html#38-comments-and-docstrings) | Docstring sections (`Args`, `Returns`, `Raises`) | Google Python style guide |
69
+ | [Ruff](https://docs.astral.sh/ruff/) | Automated linting and formatting | Enforces PEP 8 compliance automatically |
70
+ | [typing / TYPE_CHECKING](https://docs.python.org/3/library/typing.html#typing.TYPE_CHECKING) | Type hints for IDE support and static analysis | Python standard library |
71
+
72
+ ## Versioning & Releasing
73
+
74
+ This project uses [Semantic Versioning](https://semver.org/) (`vMAJOR.MINOR.PATCH`):
75
+
76
+ - **MAJOR** (`v1.0.0`, `v2.0.0`): Breaking API changes
77
+ - **MINOR** (`v0.3.0`, `v0.4.0`): New features, backward-compatible
78
+ - **PATCH** (`v0.3.1`, `v0.3.2`): Bug fixes, minor corrections
79
+
80
+ To publish a new version to [PyPI](https://pypi.org/project/cfd-ops/):
81
+
82
+ 1. Commit and push to `main`
83
+ 2. Tag and push:
84
+ ```bash
85
+ git tag -a vMAJOR.MINOR.PATCH -m "Release vMAJOR.MINOR.PATCH"
86
+ git push origin vMAJOR.MINOR.PATCH
87
+ ```
88
+
89
+ Use a signed tag when your GPG/SSH signing is configured:
90
+
91
+ ```bash
92
+ git tag -s vMAJOR.MINOR.PATCH -m "Release vMAJOR.MINOR.PATCH"
93
+ git push origin vMAJOR.MINOR.PATCH
94
+ ```
95
+
96
+ The GitHub Actions workflow will automatically build and publish to PyPI via Trusted Publishing.
97
+
98
+ ## License
99
+
100
+ BSD-3-Clause. See [LICENSE](LICENSE) for details.
@@ -0,0 +1,20 @@
1
+ .gitignore
2
+ CITATION.cff
3
+ LICENSE
4
+ README.md
5
+ mkdocs.yml
6
+ pyproject.toml
7
+ .github/workflows/docs.yml
8
+ .github/workflows/publish.yml
9
+ .github/workflows/test.yml
10
+ docs/index.md
11
+ docs/installation.md
12
+ docs/api/index.md
13
+ src/cfd_ops/__init__.py
14
+ src/cfd_ops.egg-info/PKG-INFO
15
+ src/cfd_ops.egg-info/SOURCES.txt
16
+ src/cfd_ops.egg-info/dependency_links.txt
17
+ src/cfd_ops.egg-info/requires.txt
18
+ src/cfd_ops.egg-info/top_level.txt
19
+ tests/__init__.py
20
+ tests/test_import.py
@@ -0,0 +1,12 @@
1
+ numpy>=1.24.0
2
+ cfd-io>=0.2.0
3
+
4
+ [dev]
5
+ pytest>=7.0
6
+ pytest-cov>=4.0
7
+ ruff>=0.1.0
8
+
9
+ [docs]
10
+ mkdocs<2,>=1.5
11
+ mkdocs-material>=9.0
12
+ mkdocstrings[python]>=0.24
@@ -0,0 +1 @@
1
+ cfd_ops
File without changes
@@ -0,0 +1,7 @@
1
+ """Smoke test: package imports and exposes a version."""
2
+
3
+ import cfd_ops
4
+
5
+
6
+ def test_version():
7
+ assert cfd_ops.__version__