ultralytics / msvm

Minimum Separation Vector Mapping (MSVM)

🌟 Introduction

Welcome to the MSVM (Minimum Separation Vector Mapping) project! This repository hosts the implementation of an innovative machine learning approach for geospatial information fusion and video analytics, designed to enhance situational awareness in intelligence, surveillance, and reconnaissance (ISR) applications.

📑 Description

The MSVM technique, introduced in our SPIE Defense + Security 2014 paper, employs advanced algorithms to map and analyze motion imagery for ISR tasks. For more details, please refer to our publication:

Jocher, G., et al. "Minimum Separation Vector Mapping (MSVM)." Proc. SPIE 9089, Geospatial InfoFusion and Video Analytics IV; and Motion Imagery for ISR and Situational Awareness II, 90890A (2014). DOI: 10.1117/12.2053833

🔧 Requirements

Before diving into the MSVM codebase, ensure that you have MATLAB version 2018a or newer installed, alongside the necessary toolboxes for smooth operation. Follow these steps to get started:

1. Clone the common functions repository provided by Ultralytics:

$ git clone https://github.com/ultralytics/functions-matlab

2. Add the cloned repository to your MATLAB path by executing the following command in MATLAB:

>> addpath(genpath('/path/to/functions-matlab'))

Make sure to have the following MATLAB toolboxes installed and ready:

• Statistics and Machine Learning Toolbox
• Signal Processing Toolbox

These toolboxes are essential for executing the ML algorithms within the MSVM framework.

▶️ Running the Code

To execute the MSVM estimators, simply navigate to the MATLAB environment and run the following command:

>> runEstimators

This will initiate the MSVM analysis and provide you with the output related to geospatial information fusion and video analytics.

Below is a snapshot of the expected results:

🤝 Contribute

We welcome contributions from the community! Whether you're fixing bugs, adding new features, or improving documentation, your input is invaluable. Take a look at our Contributing Guide to get started. Also, we'd love to hear about your experience with Ultralytics products. Please consider filling out our Survey. A huge 🙏 and thank you to all of our contributors!

©️ License

Ultralytics is excited to offer two different licensing options to meet your needs:

• AGPL-3.0 License: Perfect for students and hobbyists, this OSI-approved open-source license encourages collaborative learning and knowledge sharing. Please refer to the LICENSE file for detailed terms.
• Enterprise License: Ideal for commercial use, this license allows for the integration of Ultralytics software and AI models into commercial products without the open-source requirements of AGPL-3.0. For use cases that involve commercial applications, please contact us via Ultralytics Licensing.

📬 Contact Us

For bug reports, feature requests, and contributions, head to GitHub Issues. For questions and discussions about this project and other Ultralytics endeavors, join us on Discord!