كلا من numpy.conj
و numpy.conjugate
موجودان ، وفي الحقيقة فإن مستندات conj
تعرض أمثلة تستخدم conjugate
:
https://docs.scipy.org/doc/numpy-1.12.0/reference/generated/numpy.conj.html
علاوة على ذلك ، فإن صفحة numpy.conjugate غير موجودة. سيكون من الجيد جعل هذا أكثر تناسقًا ، على سبيل المثال ، قم بتغيير الأمثلة في الصفحة conj
لاستخدام conjugate
، أو أضف ملاحظة إلى مستندات conj
التي يمكن أن تكون تستخدم.
أثناء وجودنا فيه ، ربما يكون من الجيد التأكد من أننا نلاحظ أنها ، في الواقع ، مجرد أسماء مستعارة:
In [2]: np.conj is np.conjugate
Out[2]: True
انظر أيضًا np.max
و np.amax
، والتي أشعر أننا يجب أن نشجع الأول من أجلها
مرحبا. أود تناول هذا الأمر وأردت اقتراح سير عمل.
يمكننا أيضًا إنشاء صفحة منفصلة لـ np.conjugate
وتضمين الأمثلة ذات الصلة في تلك الصفحة. قم أيضًا بتغيير الأمثلة الموجودة في صفحة np.conj
لاستخدام conj
واذكر في كلتا الصفحتين أنها أسماء مستعارة لبعضها البعض وقدم مرجعًا في قسم See Also
.
هذا للحفاظ على الاتساق مع توثيق الأسماء المستعارة كما هو الحال مع على سبيل المثال ، np.random.random
function يرجى إعلامي إذا كان بإمكاني المضي قدمًا في هذا التدفق. شكرا!
@ kritisingh1 - نظرًا لأن الوظيفتين متماثلتان - np.conj is np.conjugate
- ما عليك سوى تحديث سلسلة docstring التي يشتركان فيها. أعتقد أنني سأستخدم np.conjugate
في كل مكان ، نظرًا لأنه من الجيد عمومًا عدم استخدام الاختصارات (ويتم إنشاء conj
بشكل صريح كاسم مستعار في ufuncmodule.c
). أيضًا ، يحدث هذا في حاجة إلى أقل تغيير: يمكن أن يذكر docstring فقط أن np.conj
هو اسم مستعار. لحفظ البحث: السلاسل هي numpy/core/code_generators/ufunc_docstrings.py
بعد ذلك ، فإن الخطوة التالية هي التأكد من إنشاء صفحات التوثيق لكلتا الوظيفتين. هنا ، يجب عليك ضبط كل من docs/source/reference/routines.umath.src
و docs/source/reference/ufuncs.rst
.
أثناء تواجدك فيه ، هل من الممكن أيضًا تحديث docstring remainder
للإشارة إلى أن mod
هو اسم مستعار؟ أيضًا ، لست متأكدًا تمامًا من أن القائمة الموجودة في ufuncs.rst
محدّثة في الواقع. قد يكون من الجيد المقارنة مع ما نكشفه بالفعل:
import numpy
ufuncs = [key for key in dir(numpy) if isinstance(getattr(numpy, key), numpy.ufunc)]
التعليق الأكثر فائدة
أثناء وجودنا فيه ، ربما يكون من الجيد التأكد من أننا نلاحظ أنها ، في الواقع ، مجرد أسماء مستعارة: