Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
appukuttan-shailesh authored Aug 13, 2024
1 parent 245b45f commit 3b9395d
Showing 1 changed file with 32 additions and 21 deletions.
53 changes: 32 additions & 21 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,30 +1,41 @@
# 2024-team-5-service-2: vtk-converter
# 2024-team-5- Service 2: VTK Converter

Module to convert .vtk files to their .stl and .oents
![License Badge](https://img.shields.io/badge/license-MIT-blue.svg) ![Build Status](https://img.shields.io/badge/build-passing-brightgreen.svg) ![Version](https://img.shields.io/badge/version-0.1.0-blue) [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.13308927.svg)](https://doi.org/10.5281/zenodo.13308927)

## Usage
This module is part of:
<br/><br/>
<a href="https://github.com/SPARC-FAIR-Codeathon/2024-team-5">
<image src="https://github.com/appukuttan-shailesh/testData/blob/master/SPARC2024/oSPARCHub_logo.png?raw=true" height="200px" /></a>
<br/><br/>

```console
$ make help
This oSPARC service converts .vtk files to their .stl and .obj equivalents, which have wider support with visualization libraries.

$ make build
$ make info-build
$ make tests
## Team #5 Repo

The team's main repo is located at:
https://github.com/SPARC-FAIR-Codeathon/2024-team-5

## Base Package

This oSPARC service was creating using [cookiecutter-osparc-service](
https://github.com/ITISFoundation/cookiecutter-osparc-service).


## Deployment Status

This service is awaiting deployment to oSPARC production. The GitHub actions fail, as we do not have the required permissions for the `build` stage:

> /home/scu/.venv/bin/python3: can't open file '/home/scu/.venv/bin/ooil': [Errno 13] Permission denied
Service has been deployed and tested locally via:
```
make publish-local
```

## Citation

## Workflow
Appukuttan, S., Benaribi, H., & Rievers, F. (2024). oSPARC Service #2: VTK Converter. Zenodo. https://doi.org/10.5281/zenodo.13308927

1. The source code shall be copied to the [src](vtk-converter/src/vtk_converter) folder.
2. The [Dockerfile](vtk-converter/src/Dockerfile) shall be modified to compile the source code.
3. The [.osparc](.osparc) is the configuration folder and source of truth for metadata: describes service info and expected inputs/outputs of the service.
4. The [execute](vtk-converter/service.cli/execute) shell script shall be modified to run the service using the expected inputs and retrieve the expected outputs.
5. The test input/output shall be copied to [validation](vtk-converter/validation).
6. The service docker image may be built and tested as ``make build tests`` (see usage above)
7. Optional: if your code requires specific CPU/RAM resources, edit [runtime.yml](.osparc/runtime.yml). In doubt, leave it as default.

## Have an issue or question?
Please open an issue [in this repository](https://github.com/ITISFoundation/cookiecutter-osparc-service/issues/).
---
<p align="center">
<image src="https://github.com/ITISFoundation/osparc-simcore-python-client/blob/4e8b18494f3191d55f6692a6a605818aeeb83f95/docs/_media/mwl.png" alt="Made with love at www.z43.swiss" width="20%" />
</p>
Please open an issue [here](https://github.com/SPARC-FAIR-Codeathon/2024-team-5-service-2/issues).

0 comments on commit 3b9395d

Please sign in to comment.