LostInThought - Universal Math Expression & Geographic Translator API (C++ & Blueprint)

Say goodbye to "Blueprint Spaghetti"! The Universal Math Expression & Geographic Translator API is a lightweight, high-performance C++ and Blueprint plugin designed to bridge the gap between external mathematical notation, real-world GIS coordinates, and Unreal Engine.


Whether developing educational software, scientific tools, GIS globe applications, IoT telemetry dashboards, or gameplay math parsers, this plugin converts popular external formula formats into native FMath syntax and provides ready-to-use spherical 3D coordinate transformation.


━━━━━━━━━━━━━━━━━━━━━━━━━━━━


KEY FEATURES


  1. Multi-Format & Case-Insensitive Math Parsing

    Stop chaining dozens of Sin, Cos, Divide, and Square Root nodes across your graph. The parser automatically normalizes operators, Greek variables, fractions, and case-insensitive function names across major environments:

    • LaTeX / TeX: \frac{\sin(x)}{\cos(y)} ➔ ((FMath::Sin(x)) / (FMath::Cos(y)))

    • LibreOffice Math / OpenOffice (StarMath): { sin(x) } over { cos(y) } ➔ ((FMath::Sin(x)) / (FMath::Cos(y)))

    • Exponents & Powers: Automatically converts bracketed exponents (e.g., x^{y} or (a+b)^{3}) into FMath::Pow(x, (y))

    • Excel / Spreadsheets: SQRT(x) + POWER(y, 2) / PI() ➔ FMath::Sqrt(x) + FMath::Pow(y, 2) + 3.14159265f

    • Matlab / Octave: power(x, 2) + log10(y) ➔ FMath::Pow(x, 2) + FMath::Logx(10.0f, y)

    • Standard Plain Text: sin(x) + sqrt(y) ➔ FMath::Sin(x) + FMath::Sqrt(y)

    • Greek Variable Cleanup: Automatically parses \theta, \phi, \alpha, \beta, \gamma, and \lambda into standard variable names.

  2. Geographic & Sphere Translator (GIS & IoT Ready)

    Converting standard right-handed spherical math coordinates to Unreal's left-handed coordinate system is handled automatically. The built-in Convert Lat Long To Local Vector node handles angle-to-radian conversion and X-Forward / Y-Right / Z-Up axis alignment under the hood.

    • Input real-world Latitude, Longitude, Globe Radius, and Altitude to get accurate 3D world vectors (X, Y, Z) for spawning markers, aircraft, or IoT telemetry points on 3D globes.

  3. Pure C++ Blueprint Nodes

    • Pure execution nodes (BlueprintPure) with zero Garbage Collection (GC) overhead.

    • Drop-in .uplugin architecture with zero third-party dependencies.

Showcase Note: The 3D globe dashboard screenshots demonstrate an interactive application built using the included Convert Lat Long To Local Vector node. This package contains the underlying C++ / Blueprint Math & GIS Translation API.


QUICK START GUIDE


1. Enable Plugin


  • Navigate to Edit > Plugins.

  • Search for "Math Translator", check Enabled, and restart the editor.

2. Translate Math String to UE (Blueprint)


  • In any Blueprint Event Graph, right-click and add the Translate Math Expression node.

  • Provide your mathematical string into the Expression Input pin:


    • LaTeX: \frac{\sin(x)}{\cos(y)}

    • MATLAB: power(x, 2) + log10(y)

    • Excel: SQRT(x) + POWER(y, 2)

  • The node automatically strips Greek formatting (\theta, \phi, etc.) and outputs native Unreal syntax: FMath::Pow(x, 2) + FMath::Logx(10.0f, y).

  • Route the output string to a Print String node or your custom evaluator.

3. Convert GPS Coordinates to 3D Local Vectors


  • In your Blueprint, add the Convert Lat Long To Local Vector node.

  • Connect the coordinate and sphere parameters:


    • Latitude: 37.7749

    • Longitude: -122.4194

    • Globe Radius: 6371.0

    • Altitude: 100.0

  • Connect the output Vector (X, Y, Z) into Set Actor Location or Spawn Actor to position assets in Unreal's left-handed coordinate system.

Full C++ source & documentation:


https://github.com/DVYAnalytics/MathExpressionTranslator-Docs

━━━━━━━━━━━━━━━━━━━━━━━━━━━━


简体中文产品说明 (SIMPLIFIED CHINESE)


概述 (Overview)

告别混乱、难以阅读的“蓝图意面 (Blueprint Spaghetti)”!通用数学公式转换器 API 是一款轻量级、高性能的 C++ 与蓝图插件,旨在填补外部数学记号、真实世界 GIS 坐标与虚幻引擎之间的空白。


无论您是在开发教育软件、科学工具、GIS 地球应用、物联网 (IoT) 遥测仪表盘,还是游戏性数学解析器,该插件都能将主流外部格式的公式转换为虚幻引擎原生的 FMath 语法,并提供现成的球形 3D 坐标转换功能。


核心特性 (Key Features)

• 多格式与大小写兼容数学公式解析: 支持 LaTeX / TeX、LibreOffice Math、Excel、Matlab、标准纯文本以及大括号指数幂运算。

• 希腊字母变量支持: 自动将 \theta, \phi, \alpha, \beta, \gamma, \lambda 转为标准变量名。

• 地理坐标转换器 (GIS & IoT Ready): 输入真实世界的纬度、经度、地球半径和海拔,即可获得精确对齐虚幻引擎坐标轴的 3D 世界向量。

• 极致优化的纯 C++ 蓝图节点: 使用 BlueprintPure 执行节点,零垃圾回收 (GC) 开销,零第三方依赖。

Documentation & Installation Guide:

https://github.com/DVYAnalytics/MathExpressionTranslator-Docs

Support & Issue Tracker:

https://github.com/DVYAnalytics/MathExpressionTranslator-Docs/issues