RemoteRF 2.0.1__tar.gz → 2.0.3__tar.gz

{remoterf-2.0.1/src/remoteRF.egg-info → remoterf-2.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: remoterf
-Version: 2.0.1
+Version: 2.0.3
 Summary: A python API to remotely access signal centric hardware. Client-side only! Courtesy of Wireless Lab @ UCLA & Prof. Ian Roberts.
 Author: Ethan Ge
 Author-email: ethoGalaxy@gmail.com

{remoterf-2.0.1 → remoterf-2.0.3}/setup.py

@@ -6,7 +6,7 @@ with open("README.md", "r", encoding="utf-8") as fh:
 
 setup(
     name="remoterf",
-    version="2.0.1",
+    version="2.0.3",
     author="Ethan Ge",
     author_email="ethoGalaxy@gmail.com",
     description="A python API to remotely access signal centric hardware. Client-side only! Courtesy of Wireless Lab @ UCLA & Prof. Ian Roberts.",

{remoterf-2.0.1 → remoterf-2.0.3}/src/remoteRF/common/grpc/grpc_pb2.py

@@ -2,7 +2,7 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # NO CHECKED-IN PROTOBUF GENCODE
 # source: grpc.proto
-# Protobuf Python Version: 5.29.0
+# Protobuf Python Version: 5.27.1
 """Generated protocol buffer code."""
 from google.protobuf import descriptor as _descriptor
 from google.protobuf import descriptor_pool as _descriptor_pool
@@ -12,8 +12,8 @@ from google.protobuf.internal import builder as _builder
 _runtime_version.ValidateProtobufRuntimeVersion(
     _runtime_version.Domain.PUBLIC,
     5,
-    29,
-    0,
+    27,
+    1,
     '',
     'grpc.proto'
 )
@@ -24,7 +24,7 @@ _sym_db = _symbol_database.Default()
 
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\ngrpc.proto\x12\tremote_rf\"\xa2\x01\n\x11GenericRPCRequest\x12\x15\n\rfunction_name\x18\x01 \x01(\t\x12\x34\n\x04\x61rgs\x18\x02 \x03(\x0b\x32&.remote_rf.GenericRPCRequest.ArgsEntry\x1a@\n\tArgsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\"\n\x05value\x18\x02 \x01(\x0b\x32\x13.remote_rf.Argument:\x02\x38\x01\"\x96\x01\n\x12GenericRPCResponse\x12;\n\x07results\x18\x01 \x03(\x0b\x32*.remote_rf.GenericRPCResponse.ResultsEntry\x1a\x43\n\x0cResultsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\"\n\x05value\x18\x02 \x01(\x0b\x32\x13.remote_rf.Argument:\x02\x38\x01\"\x19\n\nArrayShape\x12\x0b\n\x03\x64im\x18\x01 \x03(\x05\"+\n\rComplexNumber\x12\x0c\n\x04real\x18\x01 \x01(\x02\x12\x0c\n\x04imag\x18\x02 \x01(\x02\"a\n\x11\x43omplexNumpyArray\x12$\n\x05shape\x18\x01 \x01(\x0b\x32\x15.remote_rf.ArrayShape\x12&\n\x04\x64\x61ta\x18\x02 \x03(\x0b\x32\x18.remote_rf.ComplexNumber\"D\n\x0eRealNumpyArray\x12$\n\x05shape\x18\x01 \x01(\x0b\x32\x15.remote_rf.ArrayShape\x12\x0c\n\x04\x64\x61ta\x18\x02 \x03(\x02\"\xd7\x01\n\x08\x41rgument\x12\x16\n\x0cstring_value\x18\x01 \x01(\tH\x00\x12\x15\n\x0bint64_value\x18\x02 \x01(\x03H\x00\x12\x15\n\x0b\x66loat_value\x18\x03 \x01(\x02H\x00\x12\x14\n\nbool_value\x18\x04 \x01(\x08H\x00\x12\x35\n\rcomplex_array\x18\x05 \x01(\x0b\x32\x1c.remote_rf.ComplexNumpyArrayH\x00\x12/\n\nreal_array\x18\x06 \x01(\x0b\x32\x19.remote_rf.RealNumpyArrayH\x00\x42\x07\n\x05value2Q\n\nGenericRPC\x12\x43\n\x04\x43\x61ll\x12\x1c.remote_rf.GenericRPCRequest\x1a\x1d.remote_rf.GenericRPCResponseB\x1e\n\x10\x63om.example.demoB\nDemoProtosb\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\ngrpc.proto\x12\tremote_rf\"\xa2\x01\n\x11GenericRPCRequest\x12\x15\n\rfunction_name\x18\x01 \x01(\t\x12\x34\n\x04\x61rgs\x18\x02 \x03(\x0b\x32&.remote_rf.GenericRPCRequest.ArgsEntry\x1a@\n\tArgsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\"\n\x05value\x18\x02 \x01(\x0b\x32\x13.remote_rf.Argument:\x02\x38\x01\"\x96\x01\n\x12GenericRPCResponse\x12;\n\x07results\x18\x01 \x03(\x0b\x32*.remote_rf.GenericRPCResponse.ResultsEntry\x1a\x43\n\x0cResultsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\"\n\x05value\x18\x02 \x01(\x0b\x32\x13.remote_rf.Argument:\x02\x38\x01\"\x19\n\nArrayShape\x12\x0b\n\x03\x64im\x18\x01 \x03(\x05\"+\n\rComplexNumber\x12\x0c\n\x04real\x18\x01 \x01(\x02\x12\x0c\n\x04imag\x18\x02 \x01(\x02\"a\n\x11\x43omplexNumpyArray\x12$\n\x05shape\x18\x01 \x01(\x0b\x32\x15.remote_rf.ArrayShape\x12&\n\x04\x64\x61ta\x18\x02 \x03(\x0b\x32\x18.remote_rf.ComplexNumber\"D\n\x0eRealNumpyArray\x12$\n\x05shape\x18\x01 \x01(\x0b\x32\x15.remote_rf.ArrayShape\x12\x0c\n\x04\x64\x61ta\x18\x02 \x03(\x02\"\xed\x01\n\x08\x41rgument\x12\x16\n\x0cstring_value\x18\x01 \x01(\tH\x00\x12\x15\n\x0bint64_value\x18\x02 \x01(\x03H\x00\x12\x15\n\x0b\x66loat_value\x18\x03 \x01(\x02H\x00\x12\x14\n\nbool_value\x18\x04 \x01(\x08H\x00\x12\x35\n\rcomplex_array\x18\x05 \x01(\x0b\x32\x1c.remote_rf.ComplexNumpyArrayH\x00\x12/\n\nreal_array\x18\x06 \x01(\x0b\x32\x19.remote_rf.RealNumpyArrayH\x00\x12\x14\n\njson_value\x18\x07 \x01(\tH\x00\x42\x07\n\x05value2Q\n\nGenericRPC\x12\x43\n\x04\x43\x61ll\x12\x1c.remote_rf.GenericRPCRequest\x1a\x1d.remote_rf.GenericRPCResponseB\x1e\n\x10\x63om.example.demoB\nDemoProtosb\x06proto3')
 
 _globals = globals()
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
@@ -53,7 +53,7 @@ if not _descriptor._USE_C_DESCRIPTORS:
   _globals['_REALNUMPYARRAY']._serialized_start=514
   _globals['_REALNUMPYARRAY']._serialized_end=582
   _globals['_ARGUMENT']._serialized_start=585
-  _globals['_ARGUMENT']._serialized_end=800
-  _globals['_GENERICRPC']._serialized_start=802
-  _globals['_GENERICRPC']._serialized_end=883
+  _globals['_ARGUMENT']._serialized_end=822
+  _globals['_GENERICRPC']._serialized_start=824
+  _globals['_GENERICRPC']._serialized_end=905
 # @@protoc_insertion_point(module_scope)

remoterf-2.0.3/src/remoteRF/common/utils/process_arg.py

@@ -0,0 +1,157 @@
+from ..grpc import grpc_pb2, grpc_pb2_grpc
+import json
+import numpy as np
+
+_JSON_TYPE_KEY = "__remoterf_json_type__"
+
+def _json_safe(value):
+    if hasattr(value, "as_payload"):
+        return _json_safe(value.as_payload())
+    if isinstance(value, np.ndarray):
+        if value.dtype == object:
+            raise ValueError(f"Cannot JSON-map object-dtype array: {value!r}")
+        array = np.asarray(value)
+        if np.iscomplexobj(array):
+            data = [[float(num.real), float(num.imag)] for num in array.ravel()]
+            return {
+                _JSON_TYPE_KEY: "ndarray",
+                "dtype": str(array.dtype),
+                "shape": list(array.shape),
+                "complex": True,
+                "data": data,
+            }
+        return {
+            _JSON_TYPE_KEY: "ndarray",
+            "dtype": str(array.dtype),
+            "shape": list(array.shape),
+            "complex": False,
+            "data": array.tolist(),
+        }
+    if isinstance(value, (np.bool_,)):
+        return bool(value)
+    if isinstance(value, (np.integer,)):
+        return int(value)
+    if isinstance(value, (np.floating,)):
+        return float(value)
+    if isinstance(value, complex):
+        return {_JSON_TYPE_KEY: "complex", "real": float(value.real), "imag": float(value.imag)}
+    if isinstance(value, dict):
+        return {str(key): _json_safe(item) for key, item in value.items()}
+    if isinstance(value, (list, tuple)):
+        return [_json_safe(item) for item in value]
+    return value
+
+def _json_restore(value):
+    if isinstance(value, dict):
+        kind = value.get(_JSON_TYPE_KEY)
+        if kind == "ndarray":
+            shape = tuple(value.get("shape", ()))
+            dtype = value.get("dtype")
+            if value.get("complex"):
+                data = [complex(real, imag) for real, imag in value.get("data", [])]
+                return np.array(data, dtype=dtype or np.complex64).reshape(shape)
+            return np.array(value.get("data", []), dtype=dtype).reshape(shape)
+        if kind == "complex":
+            return complex(value.get("real", 0.0), value.get("imag", 0.0))
+        return {key: _json_restore(item) for key, item in value.items()}
+    if isinstance(value, list):
+        return [_json_restore(item) for item in value]
+    return value
+
+def unmap_arg(arg):
+    if arg.HasField('int64_value'):
+        return arg.int64_value
+    elif arg.HasField('float_value'):
+        return arg.float_value
+    elif arg.HasField('string_value'):
+        return arg.string_value
+    elif arg.HasField('bool_value'):
+        return arg.bool_value
+    elif arg.HasField('real_array'):
+        shape = tuple(arg.real_array.shape.dim)
+        return np.array(arg.real_array.data, dtype=np.float64).reshape(shape)
+    elif arg.HasField('complex_array'):
+        shape = tuple(arg.complex_array.shape.dim)
+        data = [complex(c.real, c.imag) for c in arg.complex_array.data]
+        return np.array(data, dtype=np.complex64).reshape(shape)
+    elif arg.HasField('json_value'):
+        return _json_restore(json.loads(arg.json_value))
+    else:
+        raise ValueError(f"Unknown argument type during unmapping: {arg}")
+    
+def map_arg(value):
+    arg = grpc_pb2.Argument()
+    
+    if isinstance(value, (bool, np.bool_)):
+        arg.bool_value = bool(value)
+    elif hasattr(value, "as_payload"):
+        return map_arg(value.as_payload())
+    elif value is None or isinstance(value, dict):
+        arg.json_value = json.dumps(_json_safe(value), separators=(",", ":"))
+    elif isinstance(value, (int, np.integer)):
+        arg.int64_value = int(value)
+    elif isinstance(value, (float, np.floating)):
+        arg.float_value = float(value)
+    elif isinstance(value, str):
+        arg.string_value = value
+    elif isinstance(value, (list, tuple)):
+        try:
+            array = np.asarray(value)
+        except Exception:
+            arg.json_value = json.dumps(_json_safe(value), separators=(",", ":"))
+            return arg
+        if array.dtype == object:
+            try:
+                array = np.stack(value)
+            except Exception:
+                arg.json_value = json.dumps(_json_safe(value), separators=(",", ":"))
+                return arg
+        return map_arg(array)
+    elif isinstance(value, np.ndarray):
+        if value.dtype == object:
+            raise ValueError(f"Cannot map object-dtype array: {value!r}")
+        if np.iscomplexobj(value):
+            complex_array = arg.complex_array
+            complex_array.shape.dim.extend(value.shape)
+            for num in value.ravel():
+                complex_num = complex_array.data.add()
+                complex_num.real = float(num.real)
+                complex_num.imag = float(num.imag)
+        else:
+            float_array = arg.real_array
+            float_array.shape.dim.extend(value.shape)
+            float_array.data.extend(np.asarray(value, dtype=np.float32).ravel())
+    else:
+        raise ValueError(f"Unknown argument type during mapping: {value}")
+    return arg
+        
+def map_array_proto(np_array):
+    arg = grpc_pb2.Argument()
+    
+    # Check if the array is complex
+    if np.iscomplexobj(np_array):
+        complex_array = grpc_pb2.ComplexArray()
+        for num in np_array.flat:
+            complex_number = complex_array.data.add()
+            complex_number.real = num.real
+            complex_number.imag = num.imag
+        arg.complex_array.CopyFrom(complex_array)
+    else:
+        # Handle as a regular float array
+        float_array = grpc_pb2.FloatArray()
+        float_array.data.extend(np_array.flat)
+        arg.float_array.CopyFrom(float_array)
+
+    return arg
+
+def unmap_array_proto(arg):
+    # Check which type of array is available and convert appropriately
+    if arg.HasField('complex_array'):
+        # Convert ComplexArray to a numpy array of complex numbers
+        data = [complex(cn.real, cn.imag) for cn in arg.complex_array.data]
+        return np.array(data, dtype=np.complex64)
+    elif arg.HasField('float_array'):
+        # Convert FloatArray to a numpy array of floats
+        return np.array(arg.float_array.data, dtype=np.float32)
+    else:
+        raise ValueError("Argument does not contain a recognizable array.")

{remoterf-2.0.1 → remoterf-2.0.3}/src/remoteRF/core/app.py

@@ -17,6 +17,7 @@ session = PromptSession()
 DEFAULT_TIMEZONE_NOTE = "All times are in Pacific Time (Los Angeles)"
 DEFAULT_TOS_URL = "https://remoterf.net/tos"
 SERVER_TIME_FORMAT = "%Y-%m-%d %H:%M:%S"
+BANNER_CREDIT = "Created at UCLA by E. Ge and I. Roberts."
 
 
 def _banner_note() -> str:
@@ -28,6 +29,10 @@ def _banner_note() -> str:
     return text or DEFAULT_TIMEZONE_NOTE
 
 
+def _banner_details() -> str:
+    return f"\n{BANNER_CREDIT}\nCurrent version: {print_my_version()}\n{_banner_note()}"
+
+
 def _tos_notice_text() -> str:
     notice_path = Path(__file__).resolve().parents[1] / "common" / "tos_notice.txt"
     try:
@@ -66,7 +71,7 @@ def _format_reservation_range(start_time: datetime.datetime, end_time: datetime.
     return f"{start} - {end}"
 
 def welcome():
-    printf(f"Welcome to the RemoteRF Platform", (Sty.BOLD, Sty.BLUE), f"\nCurrent version: {print_my_version()} \n{_banner_note()}", (Sty.GRAY))
+    printf(f"Welcome to the RemoteRF Platform", (Sty.BOLD, Sty.BLUE), _banner_details(), (Sty.GRAY))
     try:
         inpu = session.prompt(stylize("Please ", Sty.DEFAULT, "login", Sty.GREEN, " or ", Sty.DEFAULT, "register", Sty.RED, " to continue. (", Sty.DEFAULT, 'l', Sty.GREEN, "/", Sty.DEFAULT, 'r', Sty.RED, "): ", Sty.DEFAULT))
         if inpu == 'r':
@@ -103,7 +108,7 @@ def welcome():
         exit()
 
 def title():
-    printf(f"Welcome to the RemoteRF Platform", (Sty.BOLD, Sty.BLUE), f"\nCurrent version: {print_my_version()} \n{_banner_note()}", (Sty.GRAY))
+    printf(f"Welcome to the RemoteRF Platform", (Sty.BOLD, Sty.BLUE), _banner_details(), (Sty.GRAY))
     printf("Terms of Service: ", Sty.BOLD, _tos_url(), Sty.DEFAULT)
     # printf(f"Logged in as: ", Sty.DEFAULT, f'{account.username}', Sty.MAGENTA)
     printf(f"Input ", Sty.DEFAULT, "'help' ", Sty.BRIGHT_GREEN, "for a list of avaliable commands.", Sty.DEFAULT)