Main Content

Cette page a été traduite par traduction automatique. Cliquez ici pour voir la version originale en anglais.

rand

Créer un tableau codistribué de nombres aléatoires uniformément distribués

réduire tous les éléments de la page

    Syntaxe

    cR = rand(n,codist)
    cR = rand(sz,codist)
    cR = rand(sz1,...,szN,codist)
    cR = rand(___,datatype,codist)
    cR = rand(___,"noCommunication")
    cR = rand(___,like=p)

    Description

    exemple

    cR = rand(n,codist) crée une matrice codistribuée n-by-n de nombres aléatoires uniformément distribués et utilise codist pour spécifier la distribution des valeurs du tableau entre les workers. Chaque élément de cR est compris entre 0 et 1.

    Spécifiez codist comme "codistributed" pour utiliser le schéma de distribution codistributor1d par défaut ou le schéma de distribution défini par un objet codistributor1d ou codistributor2dbc.

    Lorsque vous créez le tableau codistribué dans un job communicant ou un bloc spmd, la fonction crée un tableau sur chaque worker. Si vous créez un tableau codistribué en dehors d'un job communicant ou d'un bloc spmd, le tableau est stocké uniquement sur le worker ou le client qui crée le tableau codistribué.

    Par défaut, le tableau codistribué a le type sous-jacent double.

    cR = rand(sz,codist) crée un tableau codistribué de nombres aléatoires uniformément distribués où le vecteur de taille sz définit la taille de cR. Par exemple, rand([2 3],"codistributed") crée un tableau codistribué 2 x 3.

    cR = rand(sz1,...,szN,codist) crée un tableau codistribué sz1-by-...-by-szN de nombres aléatoires uniformément distribués où sz1,...,szN indique la taille de chaque dimension.

    cR = rand(___,datatype,codist) crée un tableau codistribué de nombres aléatoires uniformément distribués avec le type sous-jacent datatype. Par exemple, rand(1,"single","codistributed") crée un nombre aléatoire simple précision codistribué. Vous pouvez utiliser cette syntaxe avec n'importe lequel des arguments de taille dans les syntaxes précédentes. Vous devez spécifier codist après les arguments de taille du tableau et de type de données.

    cR = rand(___,"noCommunication") crée un tableau codistribué de nombres aléatoires uniformément distribués sans utiliser la communication entre les workers.

    Lorsque vous créez de très grands tableaux ou que votre job communicant ou votre bloc spmd utilise de nombreux Workers, la communication worker-worker peut ralentir la création du tableau. Utilisez cette syntaxe pour améliorer les performances de votre code en supprimant le temps requis pour la communication worker-worker.

    Conseil

    Lorsque vous utilisez cette syntaxe, certaines étapes de vérification des erreurs sont ignorées. Utilisez cette syntaxe pour améliorer les performances de votre code après avoir prototypé votre code sans spécifier "noCommunication".

    Vous devez spécifier "noCommunication" après les arguments taille, type de données et codist.

    cR = rand(___,like=p) utilise le tableau p pour créer un tableau codistribué de nombres aléatoires uniformément distribués. Vous pouvez également spécifier "noCommunication" dans le cadre de l'appel de fonction.

    Le tableau renvoyé cR a le même type sous-jacent, la même parcimonie et la même complexité (réelle ou complexe) que p.

    Exemples

    réduire tout

    Créez une matrice double codistribuée de 1 000 x 1 000 de rand s, distribuée par sa deuxième dimension (colonnes).

    spmd(4)
    C = rand(1000,"codistributed");
end

    Avec quatre workers, chaque worker contient un morceau local de C de 1 000 x 250.

    Créez une matrice single codistribuée de 1 000 x 1 000 de rand s, distribuée par ses colonnes. 

    spmd(4)
    codist = codistributor1d(2,100*[1:spmdSize]);
    C = rand(1000,1000,"single",codist);
end

    Chaque worker contient un morceau local de 100 by-spmdIndex de C.

    Arguments d'entrée

    réduire tout

    Taille de la matrice carrée, spécifiée sous forme d'entier.

    • Si n est 0, alors cR est une matrice vide.

    • Si n est négatif, alors la fonction le traite comme 0.

    Schéma de distribution pour un tableau codistribué, spécifié comme l'une de ces options:

    • "codistributed" — Utilise le schéma de distribution par défaut défini par l'objet codistributor1d par défaut.

    • Objet codistributor1d — Utilise le schéma de distribution unidimensionnel défini dans un objet codistributor1d. Pour utiliser le schéma de distribution 1D par défaut, vous pouvez spécifier la fonction codistributor1d sans arguments.

    • Objet codistributor2dbc — Utilise le schéma de distribution cyclique par blocs bidimensionnel défini dans un objet codistributor2dbc. Pour utiliser le schéma de distribution cyclique par blocs 2D par défaut, vous pouvez spécifier la fonction codistributor2dbc sans arguments.

    Taille de chaque dimension, spécifiée sous forme de vecteur ligne d՚entiers. Chaque élément de ce vecteur indique la taille de la dimension correspondante :

    • Si la taille d'une dimension est 0, alors cR est un tableau vide.

    • Si la taille d'une dimension est négative, la fonction la traite comme 0.

    • Au-delà de la deuxième dimension, rand ignore les dimensions de fin d'une taille de 1. Par exemple, rand([3 1 1 1],"codistributed") produit un vecteur codistribué 3 sur 1 de nombres aléatoires uniformément distribués.

    Exemple : sz = [2 3 4] crée un tableau codistribué 2 x 3 x 4.

    Taille de chaque dimension, spécifiée sous forme d'arguments distincts de valeurs entières.

    • Si la taille d'une dimension est 0, alors cR est un tableau vide.

    • Si la taille d'une dimension est négative, la fonction la traite comme 0.

    • Au-delà de la deuxième dimension, la fonction ignore les dimensions de fin d'une taille de 1.

    Type de données sous-jacent du tableau renvoyé, spécifié comme l'une de ces options:

    • "double"

    • "single"

    • "logical"

    • "int8"

    • "uint8"

    • "int16"

    • "uint16"

    • "int32"

    • "uint32"

    • "int64"

    • "uint64"

    Prototype de tableau à créer, spécifié comme tableau codistributed.

    Si vous ne spécifiez pas datatype, le tableau codistribué résultant a le même type sous-jacent, la même parcimonie et la même complexité (réelle ou complexe) que p.

    Historique des versions

    Introduit dans R2006b

    Voir aussi

    | | | |

    Rubriques