Skip to main content

VectorWave Examples Guide

Quick Start​

# Simplest possible example - just run this!
mvn compile && mvn exec:java -Dexec.mainClass="com.morphiqlabs.examples.basic.GettingStarted"

Organization​

All runnable examples are now organized in src/main/java/com/morphiqlabs/examples/:

examples/
├── basic/              # Start here
│   ├── GettingStarted.java        # Minimal example - 5 steps to wavelets
│   └── WaveletRegistryBasics.java # Registry operations and safety
│
├── advanced/           # (Future) Advanced features
│
└── integration/        # External system integration
    └── MotiveWaveIntegration.java # Trading platform example

Why This Organization?​

Previously, demos and examples were scattered across:

  • src/main/java/com/morphiqlabs/demo/ (40+ files, excluded from compilation)
  • src/test/java/com/morphiqlabs/examples/
  • Various other locations

Now everything is:

  • ✅ Organized - Clear categories (basic/advanced/integration)
  • ✅ Compiled - Part of main source, not excluded
  • ✅ Runnable - Simple Maven commands
  • ✅ Documented - Each example has clear purpose

Running Examples​

# Compile once
mvn compile

# Run any example
mvn exec:java -Dexec.mainClass="com.morphiqlabs.examples.[category].[ClassName]"

Key Examples​

1. Getting Started (30 seconds)​

The absolute minimum to understand VectorWave:

mvn exec:java -Dexec.mainClass="com.morphiqlabs.examples.basic.GettingStarted"

2. Registry Basics (2 minutes)​

Learn the WaveletRegistry API:

mvn exec:java -Dexec.mainClass="com.morphiqlabs.examples.basic.WaveletRegistryBasics"

3. MotiveWave Integration (5 minutes)​

See how to use in trading platforms:

mvn exec:java -Dexec.mainClass="com.morphiqlabs.examples.integration.MotiveWaveIntegration"

Key Points​

  • Type-Safe Enum - Use WaveletName.DB4 with full IDE support
  • No String Typos - Compile-time checking with WaveletRegistry.getWavelet(WaveletName.DB4)
  • MODWT Focus - Works with ANY signal length
  • Production Ready - Safe patterns for real applications

For More Details​

See the source code in the vectorwave-examples module for complete documentation and additional examples.