{"id":30586186,"url":"https://github.com/chiefenne/openvdafs","last_synced_at":"2025-08-29T11:44:11.241Z","repository":{"id":311409818,"uuid":"1042890193","full_name":"chiefenne/OpenVDAFS","owner":"chiefenne","description":"Read, parse and plot  VDA-FS files of format versions 1.0 and 2.0","archived":false,"fork":false,"pushed_at":"2025-08-24T09:34:17.000Z","size":524,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-24T14:57:50.963Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chiefenne.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-22T18:44:21.000Z","updated_at":"2025-08-24T09:34:21.000Z","dependencies_parsed_at":"2025-08-24T14:57:53.296Z","dependency_job_id":"c3184662-9895-49b8-af5c-a8a604466a7b","html_url":"https://github.com/chiefenne/OpenVDAFS","commit_stats":null,"previous_names":["chiefenne/openvdafs"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/chiefenne/OpenVDAFS","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chiefenne%2FOpenVDAFS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chiefenne%2FOpenVDAFS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chiefenne%2FOpenVDAFS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chiefenne%2FOpenVDAFS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chiefenne","download_url":"https://codeload.github.com/chiefenne/OpenVDAFS/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chiefenne%2FOpenVDAFS/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272679430,"owners_count":24975255,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-29T02:00:10.610Z","response_time":87,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-08-29T11:44:10.742Z","updated_at":"2025-08-29T11:44:11.222Z","avatar_url":"https://github.com/chiefenne.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# OpenVDAFS\n\n\u003e **🚧 Work in Progress** - This project is under active development.\n\nA Python library and CLI for reading, parsing, inspecting, and visualizing VDA‑FS (Verband der Automobilindustrie — Flächenschnittstelle) files. VDA‑FS is a legacy CAD/CAM interchange format (primarily used in the 1980s–1990s) for exchanging curve and surface geometry. This project provides parsing, visualization, and a developer-friendly API for working with legacy automotive geometry data.\n\n## Features\n\n### ✅ Current Features\n\n- **VDA-FS Format Support**: Read and parse VDA-FS format versions 1.0 and 2.0\n- **Entity Parsing**: Full support for:\n  - `CURVE` entities (multi-segment parametric curves with monomial basis)\n  - `POINT`, `PSET`, `MDI` entities (point data)\n  - `SURF` entities (parametric surfaces) - *basic support*\n- **CLI Tool**: Command-line interface for file inspection and analysis\n- **Data Visualization**: Plot geometric entities using matplotlib\n- **Data Inspection**: Print detailed entity data including orders, parameters, and coefficients\n\n### 🔄 Planned Features\n\n- Enhanced SURF entity support with evaluation functions\n- Export capabilities to other formats\n- Interactive visualization tools\n- Batch processing utilities\n- API documentation\n\n## Installation\n\n### Prerequisites\n\n- Python 3.7+\n- matplotlib (for plotting functionality)\n\n### Setup\n\n```bash\ngit clone https://github.com/chiefenne/OpenVDAFS.git\ncd OpenVDAFS\npip install matplotlib  # For plotting functionality\n```\n\n## Usage\n\n### Command Line Interface\n\nThe CLI tool provides several commands to work with VDA-FS files:\n\n#### List Entities by Type\n\n```bash\npython cli.py file.vda --list CURVE\npython cli.py file.vda --list SURF\npython cli.py file.vda --list POINT\n```\n\n#### Visualize Entities\n\n```bash\n# Plot geometric representation\npython cli.py file.vda --plot CV3\n\n# Plot points\npython cli.py file.vda --plot PT1\n```\n\n#### Inspect Entity Data\n\n```bash\n# Print detailed entity information (orders, coefficients, parameters)\npython cli.py file.vda --plot-data CV3\n```\n\n### Example Output\n\nFor a CURVE entity, `--plot-data` shows:\n\n```\nEntity: SP1\nType: CURVE\n\n=== CURVE DETAILS ===\nNumber of segments: 4\nGlobal parameters: [0.0, 1.0, 2.0, 2.7, 4.0]\n\n--- Segment 1 ---\nOrder: 5\nParameter range: [0.0, 1.0]\nX coefficients: [0.0, 63.8891754, -51.465271, 77.0936432, -48.5175476]\nY coefficients: [0.0, 6.4475098, 56.9390259, -23.5717163, 3.1851807]\nZ coefficients: [30.0, 0.0, -60.0, 40.0, -10.0]\n\n--- Segment 2 ---\nOrder: 3\nParameter range: [1.0, 2.0]\nX coefficients: [41.0, -0.9153137, 41.9153137]\nY coefficients: [43.0, 31.1755676, 1.8244324]\nZ coefficients: [0.0, -20.0, 15.0]\n...\n```\n\n### Python API\n\n```python\nimport reader\nimport index\nimport curve_eval\n\n# Read VDA-FS file\nmodel = reader.read_vdafs('file.vda')\n\n# Build index for fast lookup\nidx = index.build_index(model)\n\n# Get a specific entity\nentity = idx['by_name']['CV3']\n\n# Decode CURVE entity\nif entity['command'] == 'CURVE':\n    curve = curve_eval.decode_curve_entity(entity)\n    # Access curve data: curve['n'], curve['segments'], etc.\n```\n\n## File Structure\n\n```\nOpenVDAFS/\n├── cli.py              # Command-line interface\n├── reader.py           # VDA-FS file parser\n├── index.py            # Entity indexing\n├── query.py            # Entity queries\n├── plot.py             # Visualization tools\n├── data_print.py       # Data inspection utilities\n├── curve_eval.py       # CURVE entity decoder and evaluator\n├── surf_eval.py        # SURF entity decoder\n└── examples/           # Example VDA-FS files\n    ├── CURVE_SP1.vda\n    └── SURF_FLAE0001.vda\n```\n\n## VDA-FS Format Support\n\n### Supported Entities\n\n| Entity Type | Read | Parse | Visualize | Data Export |\n|-------------|------|-------|-----------|-------------|\n| CURVE       | ✅   | ✅    | ✅        | ✅          |\n| SURF        | ✅   | ✅    | 🔄        | ✅          |\n| POINT       | ✅   | ✅    | ✅        | ✅          |\n| PSET        | ✅   | ✅    | ✅        | ✅          |\n| MDI         | ✅   | ✅    | ✅        | ✅          |\n\n### Format Versions\n\n- **VDA-FS 1.0**: Full support\n- **VDA-FS 2.0**: Full support\n\n## Examples\n\nThe `examples/` directory contains sample VDA-FS files for testing:\n\n- `CURVE_SP1.vda`: Multi-segment parametric curve\n- `SURF_FLAE0001.vda`: Parametric surface data\n\n## Contributing\n\nThis project is under active development. Contributions are welcome!\n\n### Development Setup\n\n1. Clone the repository\n2. Make your changes\n3. Test with example files\n4. Submit a pull request\n\n## Technical Details\n\n### CURVE Entity Structure\n\n- Multi-segment parametric curves using monomial basis\n- Each segment can have different polynomial orders\n- Global parameter knot vectors define segment boundaries\n- Coefficients grouped by coordinate (X, Y, Z)\n\n### SURF Entity Structure\n\n- Parametric surfaces with u,v parameter directions\n- Patch-based representation with bicubic or higher-order polynomials\n- Coefficient matrices for each coordinate\n\n## License\n\n[License information to be added]\n\n## References\n\n- DIN 66301: VDA-FS Format Specification\n- VDA (Verband der Automobilindustrie) Standards\n\n## Status\n\nCurrent version: 0.1.0-dev\n\nLast updated: August 2025\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchiefenne%2Fopenvdafs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchiefenne%2Fopenvdafs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchiefenne%2Fopenvdafs/lists"}