Modan2
Contents:
Installation
System Requirements
Installation Methods
Windows Installation
macOS Installation
Linux Installation
WSL (Windows Subsystem for Linux)
Troubleshooting
Qt Platform Plugin Error (Linux/WSL)
OpenGL/GLUT Errors
Missing Python Dependencies
Database Migration Issues
Performance Issues
Verifying Installation
Updating Modan2
Getting Help
Next Steps
User Guide
Getting Started
Launching Modan2
Main Window Overview
Working with Datasets
Creating a New Dataset
Dataset Variables
Importing Data
Importing 2D Images
Importing 3D Models
Importing Landmark Files
Working with Objects
Viewing an Object
Placing Landmarks (2D)
Placing Landmarks (3D)
Editing Landmark Coordinates
Missing Landmarks
Display Options
Statistical Analysis
Overview
Running an Analysis
Procrustes Superimposition
Principal Component Analysis (PCA)
Canonical Variate Analysis (CVA)
MANOVA
Handling Missing Landmarks
Visualization
2D Viewer
3D Viewer
Statistical Plots
Data Export
Exporting Datasets
Exporting Analysis Results
Keyboard Shortcuts
Global Shortcuts
Object Dialog
3D Viewer
Preferences
General Settings
Display Settings
Analysis Settings
Advanced Settings
Tips and Best Practices
Data Organization
Landmark Placement
Statistical Analysis
Performance Optimization
Common Workflows
Workflow 1: 2D Morphometric Study
Workflow 2: 3D Morphometric Study
Workflow 3: Missing Data Study
Troubleshooting
Analysis Fails
Landmarks Not Showing
Slow Performance
Next Steps
Frequently Asked Questions (FAQ)
General Questions
What is Modan2?
Who is Modan2 for?
What makes Modan2 different from other morphometrics software?
What file formats does Modan2 support?
Installation and Setup
What are the system requirements?
How do I install Modan2?
Where is my data stored?
Can I backup my data?
Data Management
What is a dataset in Modan2?
How do parent-child datasets work?
What is the difference between objects and datasets?
How many landmarks can I use?
Can I have missing landmarks?
Landmark Digitization
How do I digitize landmarks on 2D images?
How do I digitize landmarks on 3D models?
Can I edit existing landmarks?
Statistical Analysis
What analyses does Modan2 support?
How do I run a PCA analysis?
What is Procrustes superimposition?
How many objects do I need for analysis?
File Import and Export
How do I import landmark data?
Can I import from other software?
How do I export my data?
What is JSON+ZIP export?
Performance and Optimization
How fast can Modan2 handle large datasets?
Can I improve performance?
What if analysis is taking too long?
Troubleshooting
Where do I get help?
How do I report a bug?
Why does Modan2 crash?
The 3D viewer is not working
Advanced Topics
Can I use Modan2 in a publication?
Can I extend Modan2 with custom analyses?
How does the database work?
Can I run Modan2 on a server?
Development and Contributing
Is Modan2 open source?
Can I contribute to Modan2?
What features are planned?
Who develops Modan2?
License and Legal
Can I use Modan2 commercially?
What if Modan2 damages my data?
Still Have Questions?
Troubleshooting Guide
Installation Issues
Python Import Errors
Qt Platform Plugin Issues (Linux/WSL)
Permission Issues
Database Issues
Database File Corrupted
Cannot Access Database
Data Loading and Import Issues
Import File Format Not Recognized
Missing Data After Import
Image/Model Not Loading
Analysis Errors
PCA/CVA/MANOVA Fails
Procrustes Alignment Issues
Analysis Results Look Wrong
3D Visualization Issues
3D Viewer Black Screen
OpenGL Errors
Landmark Spheres Not Visible
Performance Issues
Application Slow to Start
Slow Analysis or Visualization
Out of Memory Errors
UI and Display Issues
UI Elements Not Displaying Correctly
Font Issues
High DPI Display Issues
Advanced Troubleshooting
Collecting Debug Information
Enabling Debug Logging
Running in Safe Mode
Common Error Messages
“Failed to connect to database”
“Procrustes superimposition failed”
“Not enough objects for analysis”
“Invalid landmark count”
Getting Additional Help
Known Issues and Limitations
Current Limitations
Planned Improvements
Contributing
Advanced Features Guide
Performance Optimization
Database Optimization
Large Dataset Strategies
Performance Benchmarks
Advanced Data Management
Hierarchical Datasets
Batch Operations
Database Direct Access
Advanced Statistical Analysis
Custom Analysis Workflows
Procrustes Methods
Missing Landmark Handling
3D Visualization Techniques
Advanced 3D Controls
Landmark Visualization
Model Import and Processing
Integration with External Tools
R Integration
Python/NumPy Integration
MorphoJ Compatibility
Scripting and Automation
Python API
Database Queries
Batch Export
Custom Visualizations
Matplotlib Integration
Shape Deformation Grids
Settings and Configuration
Settings File Format
Environment Variables
Tips and Tricks
Keyboard Power User Shortcuts
Workflow Optimization
Hidden Features
Further Resources
Developer Guide
Project Overview
Architecture
High-Level Overview
Database Schema
MVC Pattern in Modan2
File Formats
Development Setup
Prerequisites
Cloning the Repository
Virtual Environment Setup
Running from Source
Development Dependencies
Testing
Test Framework
Running Tests
Writing Tests
Code Style Guidelines
General Principles
Naming Conventions
Docstring Format
PyQt5 Patterns
Contributing
Git Workflow
Commit Message Guidelines
Pull Request Process
Code Review Checklist
Building Executables
PyInstaller Configuration
Platform-Specific Builds
InnoSetup Installer (Windows)
Creating Releases
Database Migrations
Creating a Migration
Running Migrations
Advanced Topics
Custom Widgets
Statistical Extensions
Plugin System (Future)
Profiling and Optimization
Debugging
Resources
Documentation
Morphometric Analysis
Community
License
Changelog
Version 0.1.5-alpha.1 (2025-09-11)
Added
Changed
Fixed
Version 0.1.4 (2025-09-10)
Added
Changed
Fixed
Previous Versions
Version 0.1.3
Version 0.1.2
Version 0.1.1
Version 0.1.0
Upcoming Features
Planned for Future Releases
Modan2
Index
Edit on GitHub
🌐
English
|
한국어
Index