linspace

Générer un vecteur espacé linéairement

Syntaxe

y = linspace(x1,x2)

y = linspace(x1,x2,n)

Description

y = linspace(x1,x2) renvoie un vecteur ligne de points uniformément espacés entre x1 et x2. Par défaut, linspace génère 100 points.

y = linspace(x1,x2,n) génère n points. L’espacement entre les points est de (x2-x1)/(n-1).

linspace est similaire à l’opérateur deux points « : » mais offre un contrôle direct sur le nombre de points et inclue toujours les points aux extrémités. « lin », que l’on trouve dans le nom « linspace », renvoie à la génération de valeurs espacées linéairement, à la différence de la fonction sœur logspace, qui génère quant à elle des valeurs espacées logarithmiquement.

Exemples

Vecteur de nombres espacés uniformément

Créez un vecteur de 100 points uniformément espacés dans l’intervalle [-5,5].

y = linspace(-5,5);

Vecteur au nombre spécifié de valeurs

Créez un vecteur de 7 points uniformément espacés dans l’intervalle [-5,5].

y1 = linspace(-5,5,7)

y1 = 1×7

   -5.0000   -3.3333   -1.6667         0    1.6667    3.3333    5.0000

Vecteur de nombres complexes espacés uniformément

Créez un vecteur de nombres complexes à 8 points uniformément espacés entre 1+2i et 10+10i.

y = linspace(1+2i,10+10i,8)

y = 1×8 complex

   1.0000 + 2.0000i   2.2857 + 3.1429i   3.5714 + 4.2857i   4.8571 + 5.4286i   6.1429 + 6.5714i   7.4286 + 7.7143i   8.7143 + 8.8571i  10.0000 +10.0000i

Arguments d'entrée

x1,x2 — Intervalle entre les points

paire de scalaires

L'intervalle entre les points, spécifié sous forme de paire de scalaires. x1 et x2 définit l’intervalle sur lequel linspace génère des points. x2 peut être soit plus grand ou plus petit que x1. Si x2 est plus petit que x1, alors le vecteur contient des valeurs décroissantes.

Types de données : single | double | datetime | duration
Support des nombres complexes : Oui

n — Nombre de points

100 (par défaut) | scalaire numérique réel | NaN

Nombre de points, spécifié sous forme de scalaire numérique réel ou de NaN.

• Si n équivaut à 1, linspace renvoie x2.

• Si n est nul ou négatif, linspace renvoie une matrice vide de 1 x 0.

• Si n n’est pas un nombre entier, linspace arrondit à l’inférieur et renvoie floor(n) points.

• Si n équivaut à NaN, linspace renvoie NaN.

Capacités étendues

Génération de code C/C++

Générez du code C et C++ avec MATLAB® Coder™.

Notes d’usage et limitations :

• Les appels à la fonction linspace avec un nombre de points égal à NaN ne sont pas supportés.

Environnement basé sur les threads

Exécutez du code en arrière-plan avec MATLAB® backgroundPool ou accélérez le code avec Parallel Computing Toolbox™ ThreadPool.

Cette fonction supporte entièrement les environnements basés sur des threads. Pour plus d’informations, consultez Run MATLAB Functions in Thread-Based Environment.

GPU Arrays

Accélérez le code en exécutant les calculs sur une unité de traitement graphique (GPU) avec Parallel Computing Toolbox™.

La fonction linspace supporte les GPU arrays avec les notes d’usage et limitations suivantes :

• Pour exécuter cette fonction sur un GPU et obtenir une sortie gpuArray, utilisez n’importe laquelle des syntaxes suivantes :

  y = gpuArray.linspace(x1,x2)
  y = gpuArray.linspace(x1,x2,n)

• Vous pouvez également spécifier x1 ou x2 en tant que gpuArray.

Pour plus d’informations, consultez Exécuter les fonctions MATLAB sur un GPU (Parallel Computing Toolbox).

Distributed arrays

Divisez les tableaux volumineux dans la mémoire combinée de votre cluster avec Parallel Computing Toolbox™.

Notes d’usage et limitations :

• Utilisez distributed.linspace pour appeler la version distribuée de linspace.

• x1 et x2 doivent être des scalaires single ou double.

Pour plus d’informations, consultez Exécuter les fonctions MATLAB avec des tableaux distribués (Parallel Computing Toolbox).

Historique des versions

Introduit avant R2006a

Voir aussi

logspace | colon