Mappy Intelligence Documentation

Importing Data

Mappy analyzes Excel (.xlsx) files where each row represents a course and its competency coverage:

• Select Open File from the sidebar to import your Excel file
• Any non-empty text in a competency cell represents coverage and serves as justification text
• For optimal visualization, include course codes in the first column
• Mappy will automatically load template.xlsx on startup, if available

Saving Changes

After modifying competency justifications:

• Select Save File to preserve your modifications for future sessions
• Choose from Excel (.xlsx), JSON (.json), or CSV (.csv) formats for your data
• Your data will be exported with all changes included

Data Structure

For optimal results, structure your data as follows:

• First column: Course codes or unique identifiers
• Second column: Course names or descriptions
• Subsequent columns: One column per competency
• Header row: Competency names or codes
• Cell content: Justification text explaining how the course addresses the competency

Radar Plots

Radar plots provide a comprehensive view of competency coverage for individual courses:

• Select a course from the dropdown to visualize its competency coverage
• Hover over radar points to see detailed justification text
• Toggle between absolute values and normalized percentages
• Compare multiple courses by enabling the "Multi-course comparison" option

Heatmaps

Heatmaps offer a bird's-eye view of competency coverage across all courses:

• Binary Heatmap: Shows presence or absence of each competency
• Intensity Heatmap: Displays the strength of coverage based on justification length
• Click on any cell to view the full justification text
• Sort courses by program sequence for progression analysis

Customizing Visualizations

Tailor visualizations to your specific needs:

• Adjust color schemes in the Settings panel
• Filter by competency groups or individual competencies
• Zoom in/out on complex visualizations
• Toggle labels and legends for cleaner presentations

Gap Analysis

Identify gaps in your curriculum coverage:

• The Curriculum Report highlights competencies with low or no coverage
• Set coverage thresholds in Settings to customize what constitutes a "gap"
• Filter by program year to identify progression issues

Redundancy Detection

Optimize your curriculum by identifying redundant coverage:

• The Overlap Report shows competencies covered by multiple courses
• View courses with similar coverage patterns
• Use this information to streamline curriculum design

Progression Analysis

Ensure competencies develop appropriately throughout a program:

• Arrange courses in sequence to visualize competency progression
• Identify competencies that are introduced but not reinforced
• Track development from introductory to mastery levels

Visualization Export

Share your visualizations with stakeholders:

• Use the Export Image button to save plots as PNG, JPG, or SVG
• Copy to clipboard for easy pasting into presentations
• Export multiple visualizations at once using the batch export option

Reports Generation

Create comprehensive reports for accreditation or review:

• Generate a complete Curriculum Report with all visualizations and analysis
• Export to PDF or HTML formats
• Customize reports to include only selected sections

Data Export

Export your processed data for use in other tools:

• Save in Excel, CSV, or JSON formats
• Export summary statistics for further analysis
• Generate data tables that can be imported into other visualization tools

Appearance Settings

Customize the application's look and feel:

• Choose between light and dark themes
• Select from predefined color palettes or create your own
• Adjust font sizes for better readability
• Configure default chart dimensions

Data Preferences

Configure how Mappy processes your data:

• Set default import/export formats
• Configure column mappings for non-standard data
• Define competency groupings for organizational purposes
• Set threshold values for gap analysis

Application Behavior

Control how the application works:

• Enable/disable auto-save functionality
• Configure startup behavior
• Set default visualization types
• Manage recent files list

File Operations

Ctrl + O	Open File
Ctrl + S	Save File
Ctrl + Shift + S	Save As...
Ctrl + E	Export Current View

Navigation

Ctrl + 1 to 5	Switch between visualization tabs
Ctrl + Tab	Next tab
Ctrl + Shift + Tab	Previous tab
F11	Toggle fullscreen mode

Editing

Ctrl + Z	Undo
Ctrl + Y	Redo
Ctrl + F	Find in justifications
F2	Edit selected cell