The Topic Mapping modules use the data generated by the Topic Distribution and Topic Clustering modules to create mappable data for the topics: position and size of topics and clusters' border. With main topics, it creates one main map. With sub topics, it will create a set of maps, one per sub topic groups (as generated in the Topic Clustering module).

The mapping information are saved in Map JSON file(s).

The Topic Mapping modules are contained in the P5_TopicMapping package.

There is currently one Topic Mapping module:

• BubbleMap (BubbleMapping package, BubbleMap.java class), which generate bubble maps data.

The Topic Mapping module entry in the project file should have the following structure:

{...
  "mapTopics": {
    "topics" | "mainTopics": "path",
    "subTopics": "path",
    "output" | "mainOutput": "path",
    "subOutput": "path",
    "mapType": "bubble",
    ...
  },
...}

• * These paths are relative to the data directory;
• ** This default value implies a non-hierarchical model, if the model type meta-parameter is set to hierarchical, a path must be provided;
• *** These paths are relative to the output directory.

There is currently only one mapType supported:

• bubble: generating a bubble map.

If you are setting the mapType to bubble, here are the additional specifications available:

{...
  "mapTopics": {
    ...
    "bubbleSize": "-",
    "bubbleScale": [5, 40],
    "targetSize": [1000,1000],
    "padding": 1,
    "curvature": 8
  },
...}

The Bubble Map assumes that the provided topics have had their distribution generated with the Topic Distribution module. To set bubble sizes, the mapping module will lookup the total weight associated with the distribution identified by bubbleSize. Distributions are named with string with a fieldName-valueField structure, as defined in the distribution's specifications.

Used on the main topics, the Topic Mapping module generates a main map JSON file with the following structure:

{
  "topics": [{
    "topicId": "0",
    "clusterId": "1",
    "size": 150,
    "labels": [{
      "weight": 165,
      "label": "laser"
    }, ... ],
    "bubbleMap": {
      "r": 26.0,
      "cx": 571.0,
      "cy": 526.0
    }
  }, ... ],
  "bubbleMapBorder": [{
    "d": "M7.1,-27.1A28.0,28.0,0,1,1,-26.6,-8.8A28.0,28.0,0,1,0,7.1,-27.1Z",
    "transform": "translate(571.2,526.9)"
  }, ... ]
}

topics contains the list of all topics to map:

• topicId identifies the topic;
• clusterId identifies the cluster in which the topic belongs;
• size represent the importance of the topic, as computed by the Topic Distribution module;
• labels is the list of labels for the topic, each having a label and weight;
• bubbleMap contains the mapping information for the topic, cx and cy being the x and y coordinate of the bubble center, and r the buble radius.

bubbleMapBorder contains the mapping detail for the borders to draw around bubbles of the same cluster:

• d is the border path;
• transform contains the transformation to apply to the border to position it around the right bubbles.

Used on the sub topics, the Topic Mapping module produces a set of map data into one JSON file:

[{
  "subMap": {
    "topics": [ ... ],
    "bubbleMapBorder": [ ... ]
  },
  "mainTopicId": "0"
}, ... ]

With:

• subMap containing the map data of the sub topics;
• mainTopicId referencing the main topic to which the sub map is assigned to.