ulab.utils — ulab yardımcı araçları

ulab.utils alt modülü, numpy.ndarray nesneleri üzerinde işlem yapan ancak standart NumPy / SciPy yüzeyinin dışında kalan küçük bir yardımcı kümesi sağlar. Yardımcılar, gömülü hedeflerde yaygın olan akış kalıpları için optimize edilmiştir – 16 bitten geniş çevre birimi arabellekleri, ayırma içermeyen büyüklük spektrumları.

Arabellek dönüştürücüler

Standart numpy.frombuffer() yalnızca numpy modülünün kendi tanımladığı dtype türlerini işler (uint8, int8, uint16, int16, float). Aşağıdaki yardımcılar bu kapsamı int16 / uint16 / int32 / uint32 bayt arabelleklerine genişletir ve tek geçişte bir float numpy.ndarray döndürür.

ulab.utils.from_int16_buffer(buffer: bytes, *, count: int = -1, offset: int = 0, out: numpy.ndarray | None = None, byteswap: bool = False) → numpy.ndarray

Bir int16 örnek arabelleğini tek geçişte bir float numpy.ndarray türüne dönüştürür.

Parametreler:

  • buffer – örnekleri tutan bytes benzeri bir arabellek.

  • count – okunacak öğe sayısı. -1, arabelleğin tamamını offset konumundan sonuna kadar okur.

  • offset – arabelleğin başında atlanacak bayt sayısı.

  • out – sonucun yazılacağı isteğe bağlı, önceden ayrılmış bir float numpy.ndarray. Verildiğinde, yeni bir dizi ayrılmaz.

  • byteswap – dönüştürmeden önce her öğenin bayt sırasını tersine çevirir – arabellek, kameranın CPU’sundan ters bayt sırasıyla yazan bir çevre biriminden geldiğinde doğru ayar budur.

Dönüşler:

count uzunluğunda bir float numpy.ndarray (veya count değeri -1 olduğunda mevcut örnek sayısında).

ulab.utils.from_uint16_buffer(buffer: bytes, *, count: int = -1, offset: int = 0, out: numpy.ndarray | None = None, byteswap: bool = False) → numpy.ndarray

Bir uint16 örnek arabelleğini tek geçişte bir float numpy.ndarray türüne dönüştürür.

Parametreler:

  • buffer – örnekleri tutan bytes benzeri bir arabellek.

  • count – okunacak öğe sayısı. -1, arabelleğin tamamını offset konumundan sonuna kadar okur.

  • offset – arabelleğin başında atlanacak bayt sayısı.

  • out – sonucun yazılacağı isteğe bağlı, önceden ayrılmış bir float numpy.ndarray. Verildiğinde, yeni bir dizi ayrılmaz.

  • byteswap – dönüştürmeden önce her öğenin bayt sırasını tersine çevirir – arabellek, kameranın CPU’sundan ters bayt sırasıyla yazan bir çevre biriminden geldiğinde doğru ayar budur.

Dönüşler:

count uzunluğunda bir float numpy.ndarray (veya count değeri -1 olduğunda mevcut örnek sayısında).

ulab.utils.from_int32_buffer(buffer: bytes, *, count: int = -1, offset: int = 0, out: numpy.ndarray | None = None, byteswap: bool = False) → numpy.ndarray

Bir int32 örnek arabelleğini tek geçişte bir float numpy.ndarray türüne dönüştürür.

Parametreler:

  • buffer – örnekleri tutan bytes benzeri bir arabellek.

  • count – okunacak öğe sayısı. -1, arabelleğin tamamını offset konumundan sonuna kadar okur.

  • offset – arabelleğin başında atlanacak bayt sayısı.

  • out – sonucun yazılacağı isteğe bağlı, önceden ayrılmış bir float numpy.ndarray. Verildiğinde, yeni bir dizi ayrılmaz.

  • byteswap – dönüştürmeden önce her öğenin bayt sırasını tersine çevirir – arabellek, kameranın CPU’sundan ters bayt sırasıyla yazan bir çevre biriminden geldiğinde doğru ayar budur.

Dönüşler:

count uzunluğunda bir float numpy.ndarray (veya count değeri -1 olduğunda mevcut örnek sayısında).

ulab.utils.from_uint32_buffer(buffer: bytes, *, count: int = -1, offset: int = 0, out: numpy.ndarray | None = None, byteswap: bool = False) → numpy.ndarray

Bir uint32 örnek arabelleğini tek geçişte bir float numpy.ndarray türüne dönüştürür.

Parametreler:

  • buffer – örnekleri tutan bytes benzeri bir arabellek.

  • count – okunacak öğe sayısı. -1, arabelleğin tamamını offset konumundan sonuna kadar okur.

  • offset – arabelleğin başında atlanacak bayt sayısı.

  • out – sonucun yazılacağı isteğe bağlı, önceden ayrılmış bir float numpy.ndarray. Verildiğinde, yeni bir dizi ayrılmaz.

  • byteswap – dönüştürmeden önce her öğenin bayt sırasını tersine çevirir – arabellek, kameranın CPU’sundan ters bayt sırasıyla yazan bir çevre biriminden geldiğinde doğru ayar budur.

Dönüşler:

count uzunluğunda bir float numpy.ndarray (veya count değeri -1 olduğunda mevcut örnek sayısında).

Spektrogram

ulab.utils.spectrogram(r: numpy.ndarray, imag: numpy.ndarray | None = None, *, scratchpad: numpy.ndarray | None = None, out: numpy.ndarray | None = None, log: bool = False) → numpy.ndarray

Girdinin ayrık Fourier dönüşümünün büyüklüğünü döndürür; kavramsal olarak numpy.fft.fft() çağrısından sonra np.sqrt(real * real + imag * imag) ifadesine eşdeğerdir – ancak açık biçimin gerektireceği ara arabellekleri ayırmadan.

Parametreler:

  • r – girdinin gerçek kısmı; 1 boyutlu bir float numpy.ndarray olarak. Uzunluğu ikinin bir kuvveti olmalıdır.

  • imag – girdinin isteğe bağlı sanal kısmı, r ile aynı şekilde. Atlandığında, girdi tamamen gerçek olarak ele alınır.

  • scratchpad – FFT için isteğe bağlı çalışma arabelleği. Verildiğinde, geçici bir çalışma dizisi ayrılmaz.

  • out – büyüklük spektrumu için isteğe bağlı, önceden ayrılmış hedef arabellek. Verildiğinde, sonuç doğrudan buna yazılır.

  • log – True olduğunda, büyüklüğün kendisi yerine büyüklüğün doğal logaritmasını döndürür.

Dönüşler:

r ile aynı uzunlukta, her frekans aralığındaki büyüklüğü (veya logaritmasını) tutan bir float numpy.ndarray.