Installation
Install with conda (recommended)
C-Star is published on conda-forge as cstar-ocean.
On a laptop or workstation, install cstar-ocean-standalone, which bundles a complete build toolchain (compilers, MPI, netCDF-Fortran, PnetCDF, CMake) so ROMS can be compiled with no system dependencies:
conda create -n cstar-env -c conda-forge cstar-ocean-standalone
On a supported HPC system (toolchain provided by Environment Modules), install just the package:
conda create -n cstar-env -c conda-forge cstar-ocean
Then conda activate cstar-env and you're ready to go.
Installation from source (developers)
To obtain the latest development version, clone this repository:
git clone https://github.com/CWorthy-ocean/C-Star.git
cd C-Star
Next, install one of the following conda environments, depending on whether you are working on a supported HPC system (environment management by Linux Environment Modules) or a generic machine like a laptop (environment-laptop.yml bundles the same conda-forge toolchain that cstar-ocean-standalone provides, for developers who prefer an editable install):
conda env create -f environment-hpc.yml # conda environment for supported HPC system
# conda env create -f environment-laptop.yml # conda environment for generic machine
Activate the conda environment:
conda activate cstar-env
Finally, install C-Star in the same environment:
pip install -e .
Run the tests
Before running the tests, you can activate the conda environment created in the previous section:
conda activate cstar-env
Check the installation of C-Star has worked by running the test suite
cd C-Star
pytest
Getting Started
To learn how to use C-Star, check out the documentation.
Feedback and contributions
If you find a bug, have a feature suggestion, or any other kind of feedback, please start a Discussion.
We also accept contributions in the form of Pull Requests.
License
C-Star is openly available for use and permissively licenced under Apache 2.0.
Copyright 2025 [C]Worthy LLC.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
2 maintainers
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file cstar_ocean-0.14.0.tar.gz.
File metadata
- Download URL: cstar_ocean-0.14.0.tar.gz
- Upload date:
- Size: 968.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ccc1acd21d02f9a1a14d41d87a991dc574b6767ea09141e432f8b02705195af0
|
|
| MD5 |
591167d9daadcf32e1c3932a7a21cad5
|
|
| BLAKE2b-256 |
17624863fe7fdadd1affe774ede1b6ace5e68199831c4a0d07106c9c53ea221d
|
Provenance
The following attestation bundles were made for cstar_ocean-0.14.0.tar.gz:
Publisher:
pypipublish.yaml on CWorthy-ocean/C-Star
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
cstar_ocean-0.14.0.tar.gz -
Subject digest:
ccc1acd21d02f9a1a14d41d87a991dc574b6767ea09141e432f8b02705195af0 - Sigstore transparency entry: 2836136963
- Sigstore integration time:
-
Permalink:
CWorthy-ocean/C-Star@a5afd617cfadc8fd4f75016e7ba12f67d88e4714 -
Branch / Tag:
refs/tags/0.14.0 - Owner: https://github.com/CWorthy-ocean
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
pypipublish.yaml@a5afd617cfadc8fd4f75016e7ba12f67d88e4714 -
Trigger Event:
release
-
Statement type:
File details
Details for the file cstar_ocean-0.14.0-py3-none-any.whl.
File metadata
- Download URL: cstar_ocean-0.14.0-py3-none-any.whl
- Upload date:
- Size: 600.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4b2365ade6204b9ef71aed04313dd20106c4c00c32ebb97773c95a9cd00bd672
|
|
| MD5 |
d204ccdd0cea8eda9584f0ce752dee61
|
|
| BLAKE2b-256 |
765ea7d4d4ff8ea77e6b485e6c5eb5e74c02d7495270dfff8fc2b5754d0389f9
|
Provenance
The following attestation bundles were made for cstar_ocean-0.14.0-py3-none-any.whl:
Publisher:
pypipublish.yaml on CWorthy-ocean/C-Star
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
cstar_ocean-0.14.0-py3-none-any.whl -
Subject digest:
4b2365ade6204b9ef71aed04313dd20106c4c00c32ebb97773c95a9cd00bd672 - Sigstore transparency entry: 2836137006
- Sigstore integration time:
-
Permalink:
CWorthy-ocean/C-Star@a5afd617cfadc8fd4f75016e7ba12f67d88e4714 -
Branch / Tag:
refs/tags/0.14.0 - Owner: https://github.com/CWorthy-ocean
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
pypipublish.yaml@a5afd617cfadc8fd4f75016e7ba12f67d88e4714 -
Trigger Event:
release
-
Statement type:
