Skip to content

About

CVT Visual Concept Map Editor is a Python application built using PyQt6 that allows users to create and edit visual concept maps.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

CVT Visual Concept Map Editor

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.

Features

  • 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.

Installation

Use Python 3.14 to create the virtual environment. On macOS, install it with Homebrew if needed:

brew install python@3.14

From 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.txt

Use 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.

Usage

  1. Run the application:

    python cvt_concept_map_visual_editor.py
  2. 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.

File Formats

  • JSON: Save and load diagrams.
  • TXT: Export list of propositions in the format: concept1, linking words, concept2.
  • SVG: Export diagrams as scalable vector graphics.

Keyboard and Mouse Controls

  • Double-click: Edit nodes or linking words.
  • Right-click: Start or end arrows.
  • Left-click: Select nodes or arrows.

Screenshots

(Add screenshots of the application interface here)

License

This project is licensed under the MIT License. See the LICENSE file for details.

Contributing

Contributions are welcome! Feel free to open issues or submit pull requests.

Contact

For questions or feedback, please contact via GitHub.

About

CVT Visual Concept Map Editor is a Python application built using PyQt6 that allows users to create and edit visual concept maps.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages