دالة MPI_Dist_graph_create_adjacent

إرجاع مؤشر إلى موصل جديد يتم إرفاق معلومات مخطط الرسم البياني الموزعة به.

بناء الجملة

int WINAPI MPI_Dist_graph_create_adjacent(
  _In_  MPI_Comm                comm_old,
        _In_range_(>=,0)  int   indegree,
        _In_reads_opt const int sources[],
        _In_reads_opt const int sourceweights[],
        _In_range_(>=,0)  int   outdegree,
        _In_reads_opt const int destinations[],
        _In_reads_opt const int destweights[],
  _In_  MPI_Info                info,
        _In_range_(0,1) int     reorder,
  _Out_ MPI_Comm                *comm_dist_graph
);

المعلمات

• comm_old [in]
  مقبض الموصل بدون معلومات الطوبولوجيا (المقبض).

• indegree
  حجم صفائف المصادرووزن المصدر (عدد صحيح غير سالب).

• المصادر[]
  رتب العمليات التي تكون عملية الاستدعاء لها هي الوجهة (صفيف الأعداد الصحيحة غير السالبة).

• موازنة المصدر[]
  أوزان الحواف المقابلة في عملية الاستدعاء (صفيف من الأعداد الصحيحة غير السالبة).

• النفاد
  حجم الوجهات وصفائف destweights (عدد صحيح غير سالب).

• وجهات[]
  صفوف العمليات التي تكون عملية الاستدعاء لها هي المصدر (صفيف الأعداد الصحيحة غير السالبة).

• destweights[]
  أوزان الحواف المقابلة خارج عملية الاستدعاء (صفيف من الأعداد الصحيحة غير السالبة).

• معلومات [in]
  تلميحات حول تحسين أو تفسير الأوزان (مقبض). تستخدم حاليا MPI_INFO_NULL حيث لا يتم استخدام هذا المتغير داخليا.

• اعاده ترتيب
  قد تتم إعادة ترتيب الرتب (صحيح) أو لا (خطأ) (منطقي). حاليا لا يتم استخدام هذا داخليا.

• comm_dist_graph [خارج]
  التعامل مع الموصل مع معلومات تخطيط الرسم البياني الموزعة المرفقة (المقبض).

القيمة المُرجعة

إرجاع MPI_SUCCESS عند النجاح. وإلا، فإن القيمة المرجعة هي رمز خطأ.

في Fortran، يتم تخزين القيمة المرجعة في المعلمة IERROR .

Fortran

    MPI_DIST_GRAPH_CREATE_ADJACENT (COMM_OLD, INDEGREE, SOURCES, SOURCEWEIGHTS,
    OUTDEGREE, DESTINATIONS, DESTWEIGHTS, INFO, REORDER,
    COMM_DIST_GRAPH, IERROR)
        INTEGER COMM_OLD, INDEGREE, SOURCES (*), SOURCEWEIGHTS (*), OUTDEGREE,
    DESTINATIONS (*), DESTWEIGHTS (*), INFO, COMM_DIST_GRAPH, IERROR
        LOGICAL REORDER

الملاحظات

تمرر كل عملية في comm_old communicator جميع المعلومات حول حوافها الواردة والصادرة في مخطط الرسم البياني الموزع الظاهري. يجب أن تضمن عمليات الاستدعاء وصف كل حافة من حافة الرسم البياني في المصدر وفي عملية الوجهة بنفس الوزن، إذا كان الرسم البياني مرجحا. إذا كانت هناك حواف متعددة لزوج وجهة مصدر معين، فإن تسلسل أوزان هذه الحواف لا يهم.

مخطط الاتصال الكامل هو مزيج من جميع الحواف الموضحة في صفيف المصادر لجميع العمليات في comm_old، والتي يجب أن تكون متطابقة مع مجموعة جميع الحواف الموضحة في صفيف الوجهات . يجب أن تكون رتب المصدر والوجهة هي صفوف معالجة comm_old. يسمح هذا بمواصفات موزعة بالكامل للرسم البياني للاتصال. العمليات المعزولة، أي العمليات التي لا تحتوي على حواف واردة أو صادرة في الطوبولوجيا الموزعة، وبالتالي يكون لها indegree أو outdegree أو كليهما، كصفر، مسموح بها.

عدد العمليات في الموصل الذي تم إنشاؤه حديثا، comm_dist_graph، مطابق لعدد العمليات في comm_old. استدعاء هذه الدالة جماعي.

يتم تحديد الأوزان كأعداد صحيحة غير سالبة باستخدام مصفوفات وزن المصدر و destweights ، إذا كان الرسم البياني هو رسم بياني مرجح. سيحتاج التطبيق إلى تحديد MPI_UNWEIGHTED لكل من مصفوفات المصدروdestweights للإشارة إلى أن جميع الحواف لها نفس الوزن (لا) بشكل فعال. من الخطأ توفير MPI_UNWEIGHTED لبعض عمليات comm_old وليس جميعها. السلوك في مثل هذه الحالة غير مضمون. إذا كان الرسم البياني مرجحا، ولكن indegree أو outdegree هو صفر لعملية ما، فقد يتم تمرير MPI_WEIGHTS_EMPTY أو أي صفيف عشوائي إلى ثقل المصدر أو destweights بواسطة تلك العملية.

المتطلبات

منتج	Microsoft MPI v6
الرأس	Mpi.h؛ Mpif.h
المكتبة	Msmpi.lib
Dll	Msmpi.dll

راجع أيضًا

وظائف طبولوجيا عملية MPI

MPI_Dist_graph_create

MPI_Dist_graph_neighbors_count

MPI_Dist_graph_neighbors