ulab.utils --- مساعدات أدوات ulab

توفر الوحدة الفرعية ulab.utils مجموعة صغيرة من المساعدات التي تعمل على كائنات numpy.ndarray لكنها تعيش خارج السطح القياسي لـ NumPy / SciPy. وقد ضُبطت هذه المساعدات لأنماط التدفق الشائعة على الأهداف المضمَّنة -- المخازن المؤقتة للطرفيات الأعرض من 16 بت، وأطياف المقدار الخالية من التخصيص.

محوّلات المخزن المؤقت

إن numpy.frombuffer() القياسية لا تتعامل إلا مع الأنواع التي تعرّفها numpy نفسها (uint8 وint8 وuint16 وint16 وfloat). وتوسّع المساعدات أدناه تلك التغطية لتشمل مخازن البايتات من النوع int16 / uint16 / int32 / uint32 وتُعيد numpy.ndarray من الأعداد العشرية في مرور واحد.

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

تحويل مخزن مؤقت من عينات int16 إلى numpy.ndarray من الأعداد العشرية في مرور واحد.

المعاملات:

• buffer -- مخزن مؤقت شبيه بـ bytes يحمل العينات.

• count -- عدد العناصر المراد قراءتها. تقرأ القيمة -1 المخزن المؤقت بأكمله من offset حتى النهاية.

• offset -- عدد البايتات المراد تخطيها في بداية المخزن المؤقت.

• out -- numpy.ndarray اختيارية مخصصة مسبقًا من الأعداد العشرية لكتابة النتيجة فيها. وعند تقديمها، لا تُخصَّص أي مصفوفة جديدة.

• byteswap -- عكس ترتيب بايتات كل عنصر قبل التحويل -- وهو الإعداد الصحيح عندما يأتي المخزن المؤقت من طرفية كتبت بترتيب بايتات معاكس لترتيب وحدة المعالجة المركزية للكاميرا.

يُعيد:

numpy.ndarray من الأعداد العشرية بطول count (أو بعدد العينات المتاحة عندما يكون count هو -1).

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

تحويل مخزن مؤقت من عينات uint16 إلى numpy.ndarray من الأعداد العشرية في مرور واحد.

المعاملات:

• buffer -- مخزن مؤقت شبيه بـ bytes يحمل العينات.

• count -- عدد العناصر المراد قراءتها. تقرأ القيمة -1 المخزن المؤقت بأكمله من offset حتى النهاية.

• offset -- عدد البايتات المراد تخطيها في بداية المخزن المؤقت.

• out -- numpy.ndarray اختيارية مخصصة مسبقًا من الأعداد العشرية لكتابة النتيجة فيها. وعند تقديمها، لا تُخصَّص أي مصفوفة جديدة.

• byteswap -- عكس ترتيب بايتات كل عنصر قبل التحويل -- وهو الإعداد الصحيح عندما يأتي المخزن المؤقت من طرفية كتبت بترتيب بايتات معاكس لترتيب وحدة المعالجة المركزية للكاميرا.

يُعيد:

numpy.ndarray من الأعداد العشرية بطول count (أو بعدد العينات المتاحة عندما يكون count هو -1).

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

تحويل مخزن مؤقت من عينات int32 إلى numpy.ndarray من الأعداد العشرية في مرور واحد.

المعاملات:

• buffer -- مخزن مؤقت شبيه بـ bytes يحمل العينات.

• count -- عدد العناصر المراد قراءتها. تقرأ القيمة -1 المخزن المؤقت بأكمله من offset حتى النهاية.

• offset -- عدد البايتات المراد تخطيها في بداية المخزن المؤقت.

• out -- numpy.ndarray اختيارية مخصصة مسبقًا من الأعداد العشرية لكتابة النتيجة فيها. وعند تقديمها، لا تُخصَّص أي مصفوفة جديدة.

• byteswap -- عكس ترتيب بايتات كل عنصر قبل التحويل -- وهو الإعداد الصحيح عندما يأتي المخزن المؤقت من طرفية كتبت بترتيب بايتات معاكس لترتيب وحدة المعالجة المركزية للكاميرا.

يُعيد:

numpy.ndarray من الأعداد العشرية بطول count (أو بعدد العينات المتاحة عندما يكون count هو -1).

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

تحويل مخزن مؤقت من عينات uint32 إلى numpy.ndarray من الأعداد العشرية في مرور واحد.

المعاملات:

• buffer -- مخزن مؤقت شبيه بـ bytes يحمل العينات.

• count -- عدد العناصر المراد قراءتها. تقرأ القيمة -1 المخزن المؤقت بأكمله من offset حتى النهاية.

• offset -- عدد البايتات المراد تخطيها في بداية المخزن المؤقت.

• out -- numpy.ndarray اختيارية مخصصة مسبقًا من الأعداد العشرية لكتابة النتيجة فيها. وعند تقديمها، لا تُخصَّص أي مصفوفة جديدة.

• byteswap -- عكس ترتيب بايتات كل عنصر قبل التحويل -- وهو الإعداد الصحيح عندما يأتي المخزن المؤقت من طرفية كتبت بترتيب بايتات معاكس لترتيب وحدة المعالجة المركزية للكاميرا.

يُعيد:

numpy.ndarray من الأعداد العشرية بطول count (أو بعدد العينات المتاحة عندما يكون count هو -1).

مخطط طيفي

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

إعادة مقدار تحويل فورييه المتقطع للدخل، وهو مكافئ من حيث المفهوم لـ np.sqrt(real * real + imag * imag) بعد استدعاء numpy.fft.fft() -- دون تخصيص المخازن المؤقتة الوسيطة التي تخصصها الصيغة الصريحة.

المعاملات:

• r -- الجزء الحقيقي من الدخل بوصفه numpy.ndarray أحادية البُعد من الأعداد العشرية. يجب أن يكون طوله قوة من قوى الاثنين.

• imag -- الجزء التخيّلي الاختياري من الدخل، بالشكل نفسه الذي لـ r. عند حذفه، يُعامَل الدخل على أنه حقيقي محض.

• scratchpad -- مخزن مؤقت عامل اختياري لتحويل FFT. عند تقديمه، لا تُخصَّص أي مصفوفة عمل مؤقتة.

• out -- مخزن مؤقت وجهة اختياري مخصص مسبقًا لطيف المقدار. عند تقديمه، تُكتب النتيجة فيه مباشرةً.

• log -- عند True، يُعاد اللوغاريتم الطبيعي للمقدار بدلًا من المقدار نفسه.

يُعيد:

numpy.ndarray من الأعداد العشرية بالطول نفسه الذي لـ r تحمل المقدار (أو لوغاريتمه) عند كل نطاق ترددي.