Add set_license API, alias, and docs

Introduce a new set_license API for configuring licenses and add documentation for license handling. Changes include:

- Documentation: add a comprehensive "License Configuration" section to installation.rst describing automatic detection (license_RadarSimPy_*.lic), manual configuration (radarsimpy.set_license), status checks, examples, and free-tier behavior.
- Python package API: update src/radarsimpy/__init__.py to import and call set_license() at import time, expose set_license in __all__, and keep initialize_license as a backwards-compatible alias.
- Cython bindings: update src/radarsimpy/includes/radarsimc.pxd to declare LicenseManager::SetLicense variants (string and vector[string]) replacing Initialize.
- Implementation: replace initialize_license with set_license in src/radarsimpy/license.pyx, call the C++ SetLicense method, handle automatic discovery and explicit paths, and add initialize_license = set_license as compatibility alias.
- Submodule: bump src/radarsimcpp submodule reference to the new commit.

These changes allow setting or updating the license at runtime, support multiple license files, and preserve backwards compatibility with code using initialize_license.

Author: zpeng

gen_docs/user_guide/installation.rst

@@ -89,6 +89,98 @@ You should see output similar to:
 
     RadarSimPy version: 14.x.x
 
+License Configuration
+---------------------
+
+RadarSimPy supports both free tier and licensed operation modes. License files enable access to advanced features and remove free tier limitations.
+
+License File Placement
+^^^^^^^^^^^^^^^^^^^^^^
+
+**Automatic Detection**
+
+The simplest way to activate your license is to place the license file in the ``radarsimpy/`` package directory:
+
+.. code-block:: none
+
+    your_project/
+    ├── your_script.py
+    └── radarsimpy/
+        ├── __init__.py
+        ├── license_RadarSimPy_customer.lic    # Your license file
+        ├── radar.py
+        └── ...
+
+License files must follow the naming pattern: ``license_RadarSimPy_*.lic``
+
+.. note::
+   RadarSimPy automatically searches for and validates all ``license_RadarSimPy_*.lic`` files in the package directory. As long as one valid license is found, full functionality is enabled.
+
+**Multiple License Files**
+
+You can place multiple license files in the directory. The system will try each one until a valid license is found:
+
+.. code-block:: none
+
+    radarsimpy/
+    ├── license_RadarSimPy_company.lic
+    ├── license_RadarSimPy_backup.lic
+    └── license_RadarSimPy_trial.lic
+
+Manual License Configuration
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+If you need to specify a license file from a custom location, or update the license at runtime:
+
+.. code-block:: python
+
+    import radarsimpy
+    
+    # Set license with a specific license file
+    radarsimpy.set_license("/path/to/your/license_RadarSimPy_customer.lic")
+    
+    # Check if license is active
+    if radarsimpy.is_licensed():
+        print("Full license active")
+        print(radarsimpy.get_license_info())
+    else:
+        print("Running in free tier mode")
+
+Checking License Status
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+You can verify your license status at any time:
+
+.. code-block:: python
+
+    import radarsimpy
+    
+    # Check license status
+    if radarsimpy.is_licensed():
+        # Get license information
+        info = radarsimpy.get_license_info()
+        print(f"License info: {info}")
+    else:
+        print("Running in free tier mode with limitations")
+
+**Example Output**
+
+.. code-block:: none
+
+    License info: Licensed to: Company Name (365 days remaining)
+
+Free Tier Mode
+^^^^^^^^^^^^^^
+
+If no valid license file is found, RadarSimPy automatically operates in free tier mode with certain limitations:
+
+- Limited target complexity
+- Reduced simulation fidelity options
+- Other feature restrictions as documented
+
+.. tip::
+   To obtain a license file, visit `radarsimx.com <https://radarsimx.com/product/radarsimpy/>`_ or contact info@radarsimx.com.
+
 Building from Source
 ---------------------
 

src/radarsimcpp

@@ -48,11 +48,11 @@
 from .simulator import sim_radar
 from .simulator import sim_lidar
 from .simulator import sim_rcs
-from .license import initialize_license, is_licensed, get_license_info
+from .license import set_license, initialize_license, is_licensed, get_license_info
 
 _simulation_available = True
 
-initialize_license()
+set_license()
 # except ImportError:
 #     _simulation_available = False
 
@@ -82,7 +82,8 @@
     "sim_lidar",
     "sim_rcs",
     # License Functions (if available)
-    "initialize_license",
+    "set_license",
+    "initialize_license",  # Backwards compatibility
     "is_licensed",
     "is_free_tier",
     "get_license_info",
@@ -100,7 +101,7 @@
 # Remove simulation and license functions from __all__ if not available
 if not _simulation_available:
     for func in ["sim_radar", "sim_lidar", "sim_rcs", 
-                 "initialize_license", "is_licensed", "is_free_tier", "get_license_info"]:
+                 "set_license", "initialize_license", "is_licensed", "is_free_tier", "get_license_info"]:
         if func in __all__:
             __all__.remove(func)
 
@@ -285,7 +286,7 @@ def hello():
        >>> range_doppler = rs.processing.range_doppler_fft(result['baseband'])
     
     💡 License: Automatically detected from module directory (license_RadarSimPy_*.lic)
-       Or manually specify: rs.initialize_license('/path/to/license.lic')
+       Or manually specify: rs.set_license('/path/to/license.lic')
     
     �📚 Documentation: https://radarsimx.github.io/radarsimpy/
     💬 Support: info@radarsimx.com

src/radarsimpy/__init__.py

@@ -101,8 +101,8 @@ cdef extern from "libs/license_manager.hpp":
     cdef cppclass LicenseManager:
         @staticmethod
         LicenseManager& GetInstance()
-        void Initialize(const string& license_file_path)
-        void Initialize(const vector[string]& license_file_paths)
+        void SetLicense(const string& license_file_path)
+        void SetLicense(const vector[string]& license_file_paths)
         bint IsLicensed() const
         bint IsFreeTier() const
         string GetLicenseInfo() const

src/radarsimpy/includes/radarsimc.pxd

@@ -30,9 +30,9 @@ import os
 import glob
 
 
-def initialize_license(license_file_path=None):
+def set_license(license_file_path=None):
     """
-    Initialize the license manager with a license file.
+    Set or update the license for RadarSimPy.
     
     Args:
         license_file_path (str, optional): Path to license file. If None, automatically 
@@ -41,12 +41,13 @@ def initialize_license(license_file_path=None):
     Example:
         >>> import radarsimpy
         >>> # Explicit path
-        >>> radarsimpy.initialize_license("/path/to/license_RadarSimPy_customer.lic")
+        >>> radarsimpy.set_license("/path/to/license_RadarSimPy_customer.lic")
         >>> if radarsimpy.is_licensed():
         ...     print("Full license active")
         
     Note:
-        Typically called automatically by the package during import with auto-detected license path.
+        Can be called multiple times to update or recheck license files.
+        Typically called automatically by the package during import.
     """
     cdef string cpp_license_path
     cdef vector[string] cpp_license_paths
@@ -61,15 +62,19 @@ def initialize_license(license_file_path=None):
             # Pass all found license files to C++
             for lic_file in license_files:
                 cpp_license_paths.push_back(lic_file.encode('utf-8'))
-            LicenseManager.GetInstance().Initialize(cpp_license_paths)
+            LicenseManager.GetInstance().SetLicense(cpp_license_paths)
         else:
             # No license files found, use empty string (free tier mode)
             cpp_license_path = b""
-            LicenseManager.GetInstance().Initialize(cpp_license_path)
+            LicenseManager.GetInstance().SetLicense(cpp_license_path)
     else:
         # Use provided path
         cpp_license_path = license_file_path.encode('utf-8')
-        LicenseManager.GetInstance().Initialize(cpp_license_path)
+        LicenseManager.GetInstance().SetLicense(cpp_license_path)
+
+
+# Backwards compatibility alias
+initialize_license = set_license
 
 
 def is_licensed():