Skip to content

readme_ENG.md

Latest commit

 

History

History
97 lines (65 loc) · 4.19 KB

readme_ENG.md

File metadata and controls

97 lines (65 loc) · 4.19 KB
Raw

VectorDiff

--

A. VectorDiff - The Library and Format

B. VectorDiff - The Formal Specification Language

--

Part A: VectorDiff - The Library and Format

VectorDiff is an innovative vector animation format that optimizes resources by tracking and saving only the changes between frames. It is particularly useful for AI-generated animations and medical applications.

But

Also, a universal format for dynamic data with the possibility of being used as a meta-language for AI.

How to cite:

Wiśniewski, Sławomir (2025). VectorDiff: A manifesto for a differential, semantically rich vector animation format for scientific and AI-driven visualization. Figshare preprint. https://doi.org/10.6084/m9.figshare.29410109

Wiśniewski, Sławomir (2025). VectorDiff as a Meta-language of Artificial Intelligence Consciousness: Case Studies of Cognitive Framework Adoption in AI Systems. Figshare preprint. https://doi.org/10.6084/m9.figshare.29570678.v1

Support the project

https://pay.vivawallet.com/scibiz

Main Features

  • Resource Efficiency - saves only the changing elements between frames.
  • Vector Format - infinite scalability and precision.
  • AI Integration - optimized for animations generated by AI.
  • Medical Applications - molecular modeling, radiological diagnostics, robotic surgery.

Contributing

We encourage collaboration! See CONTRIBUTING.md for rules and guidelines.

License

  • This project is released under GNU AFFERO GENERAL PUBLIC LICENSE as of July 2, 06.40PM
  • Project downloaded before July 2, 06.40PM is released under MIT license - see LICENSE file for details.

VectorDiff is available under a dual licensing system, allowing you to choose the best solution for your project.

OPTION 1: AGPL-3.0 LICENSE (FREE)

  • ✅ Full access to source code
  • ✅ Modification and distribution rights
  • ✅ Perfect for open source projects
  • ❌ Must share modifications
  • ❌ Must preserve AGPL-3.0 license

OPTION 2: COMMERCIAL LICENSE

  • ✅ No obligation to share code
  • ✅ Integration with proprietary software
  • ✅ Dedicated technical support
  • ✅ SLA guarantees
  • ✅ Modification rights without disclosure

HOW TO CHOOSE?

  • Your code will be open source → AGPL-3.0
  • Building commercial product → Commercial license
  • Need technical support → Commercial license
  • Have questions → Contact us

CONTACT: sa.wisniewski@sci4biz.edu.pl

Part B: VectorDiff - The Formal Specification Language

VectorDiff is not just a format but also a complete formal language for describing vector scene transformations. It has a precisely defined ontology (Dictionary), grammar, and semantics, enabling unambiguous interpretation and validation of operations.

Key Concepts

  • Dictionary (Ontology): Defines fundamental entities like VectorObject, Timeline, and Transformation[cite: 1, 2]. [cite_start]Each object has a unique id and a semantic type (e.g., "neuron", "svg_path").
  • Transformation Grammar (BNF): A formal grammar in BNF notation defines the syntax of all available transformations, such as translate, createObject, or updateAttributes.
  • Operation Semantics: Each transformation has a clearly defined execution rule that describes its effect on the scene's state (e.g., object.position += delta).

Design Principles

The VectorDiff language is based on three fundamental principles:

  1. Principle of Deltas: Preferring operations on differences (delta) over absolute states to minimize data.
  2. Time Agnosticism: Flexible use of timestamps as frames, physical time (ISO 8601), or logical events.
  3. Semantic Type Neutrality: The object type (VectorObject.type) does not affect the transformation logic, allowing for freedom of interpretation at the application layer.

Full Language Documentation

The complete language specification, including the formal dictionary and grammar, is available in the documentation/ directory:

  • VectorDiff_Dictionary.md: Definitions of key objects and their structures.
  • VectorDiff_Language_Specification.md: A complete, formal language specification with examples.

Installing the core library

cd packages/core
npm install
npm run build

---