CVT Visual Concept Map Editor is a Python application built using PyQt6 that allows users to create and edit visual concept maps.
It provides an intuitive interface for creating nodes, linking them with text, and forming propositions.
The application supports saving, loading, exporting, and zooming functionalities.
- Concept Nodes: Create rounded rectangles representing concepts.
- Text Nodes: Add linking words between concepts.
- Propositions: Form connections between concepts and linking words.
- Proposition Pane: View the propositions formed by the current map in a pane to the right of the canvas.
- Editing: Double-click to edit text of nodes or linking words.
- Arrow Creation: Right-click to start and end arrows between nodes.
- Arrow Constraints: Each arrow must connect one concept node and one linking-word text node. Either direction is allowed; concept-to-concept and text-to-text arrows are rejected.
- Zooming: Zoom in and out for better visualization.
- Scrolling: Scroll the canvas for large diagrams.
- Export: Save diagrams as JSON, export tuples as text files, or export diagrams as SVG.
You can export the map as a comma delimited text file where each proposition in the map has the form:
concept1, linking words, concept2
This is very useful for inputting into Generative AI.
We wrote this tool for readers of our book "Generative Analysis". You can find out much more about Concept Maps anand d proositions how to use them effectively with Generative AI in the book.
Use Python 3.14 to create the virtual environment. On macOS, install it with Homebrew if needed:
brew install python@3.14From the project directory, create and activate the environment, then install the tested dependencies:
python3.14 -m venv venv
source venv/bin/activate
python -m pip install -r requirements.txtUse the non-hidden venv directory on macOS. Qt's plugin scanner treats the platform plugins inside a dot-prefixed .venv as hidden and then cannot load the Cocoa plugin.
-
Run the application:
python cvt_concept_map_visual_editor.py
-
Use the toolbar buttons to:
- Add concept nodes or linking words nodes.
- Delete selected nodes or arrows.
- Use the File menu to save/load diagrams and export propositions or SVG.
- Zoom in or out.
- JSON: Save and load diagrams.
- TXT: Export list of propositions in the format:
concept1, linking words, concept2. - SVG: Export diagrams as scalable vector graphics.
- Double-click: Edit nodes or linking words.
- Right-click: Start or end arrows.
- Left-click: Select nodes or arrows.
(Add screenshots of the application interface here)
This project is licensed under the MIT License. See the LICENSE file for details.
Contributions are welcome! Feel free to open issues or submit pull requests.
For questions or feedback, please contact via GitHub.