export-map

Export Map

Export the map currently open in Gephi: a clean PNG, a labeled PNG, and an SVG. This command exports; it does not lay out or style. The map has to be a map first (laid out, sized, colored), which /visualize or /analyze-network does.

Tell the user what you're doing at each step — narrate briefly before each tool call so they know what's happening.

Steps

1. Health check: Call gephi_health_check. If it fails, tell the user to start Gephi and stop.

2. Graph info: Call gephi_get_project_info. Tell the user the node/edge counts. If the graph is empty, stop and tell them.

3. Is it a map yet? Call gephi_visual_qa (with the partition column if the graph has one). If its warnings include the "looks untouched" warning, or sizes.flat is true and colors.distinct is 1, the graph has been loaded but not laid out or styled: exporting now produces the block of overlapping default nodes. Say that, and offer the recommended path: run /visualize (layout, sizes, colors, with a visual check) and then export. Only continue without it if the user says so. If visual_qa returns other warnings (invisible sizes, near-white colors, an exploded layout), fix or flag them before exporting.

4. Set preview settings for clean export (no labels). Call gephi_set_preview_settings with:

   {
     "node.label.show": false,
     "edge.opacity": 25,
     "edge.curved": true,
     "edge.color": "source",
     "edge.thickness": 2.0,
     "node.opacity": 100,
     "node.border.width": 0.3,
     "arrow.size": 0
   }
   

   Tell the user: "Setting preview to clean mode — no labels, community-colored edges."

5. Export clean PNG: Call gephi_export_png with file set to the user's path or ~/Desktop/network.png, at width: 3840, height: 2160. Tell the user: "Exporting clean PNG at 4K resolution..."

6. Enable labels and export annotated version:

   • Call gephi_set_preview_settings with:

     {
       "node.label.show": true,
       "node.label.proportinalSize": false,
       "node.label.font": "Arial 10 Plain",
       "node.label.outline.size": 4,
       "node.label.outline.opacity": 95,
       "edge.opacity": 15
     }
     

   • Export with _labeled suffix. Tell the user: "Exporting labeled version..."