Документирование процедур CBLAS - PullRequest
0 голосов
/ 27 декабря 2018

(Примечание: я видел: Какая-нибудь хорошая документация для интерфейса cblas? , но ссылка в ответе устарела и, похоже, в любом случае не похожа на официальную документацию.)

Я начал изучать CBLAS и окружающие библиотеки, потому что хотел бы использовать их для умножения матриц и векторов.Например, я нашел следующий веб-сайт немного полезным, объясняя некоторые термины и библиотеки, и он даже показывает с небольшим кодом, как сделать умножение и как решить систему линейных уравнений: https://www.seehuhn.de/pages/linear

Однаконазвания этих процедур настолько загадочны, что я понятия не имею, что они могут обозначать.Я даже не знаю, следует ли мне использовать одни и те же процедуры в других сценариях, чем те, что на этом сайте, потому что название процедуры не дает мне никаких подсказок.( «Могу ли я использовать эту процедуру для всех умножений?» «Когда мне нужно использовать что-то другое?» «Что это за аргументы?» ) Я думаю, что это действительно плохо названо, и я чувствую, что кто-то играетплохая шутка на меня с точки зрения читабельности.Почему нет более описательных имен?(Примечание: в моей системе нет пакета «refblas», который я мог бы установить для чтения файлов, упомянутых на сайте.)

Тем не менее, я хотел бы понять, как использовать эту вещь.

Я понимаю различные уровни операций, которые явно определены в библиотеке.Векторные операции уровня 1, матричный вектор уровня 2, матричная матрица уровня 3 - это имеет смысл для меня.Тем не менее, это не отражено в названиях этих процедур, как ни странно.

Поэтому мой вопрос: где я могу найти исчерпывающую документацию, содержащую объяснение того, что делает каждая из процедур в библиотеке, какие параметры она имеет?сведения о лучших практиках и т. д., возможно, с объяснениями также названий процедур и их значения?Может быть, есть даже более длинные и более описательные имена, псевдонимы для этих процедур, но люди их не используют?

...