Étape 4: Envoyer des données avec MATLAB
Donc la première chose que vous devez faire est d’ajouter le répertoire où vous avez enregistré les fichiers de données de l’API dans le répertoire MATLAB.
Vous pouvez le faire en ajoutant ces lignes dans votre code :
>>> api_path = ' C: / Program Files/MATLAB/plotlyAPI/plotly ' ;
>>> addpath(genpath(api_path))
N’oubliez pas de changer le répertoire ci-dessus, au cas où vous avez utilisé un autre endroit que moi.
Authentification :
Maintenant, vous devez signer votre compte plotly par le biais de votre code. Ceci est fait en utilisant cette ligne :
>>> inscription ('joaoduarte', « my_api_key »)
Vous devez modifier les chaînes en conséquence à vos paramètres. La première chaîne est votre nom d’utilisateur plotly, dans mon cas c’est « joaoduarte » et la deuxième chaîne est votre clé API, que vous avez généré à l’étape précédente, dans les paramètres de votre profil plotly.
Personnellement, j’aime à mettre ces lignes avec des paramètres sur le début de mon code, car ils font partie des configurations générales, mais vous pouvez les utiliser n’importe où vous voulez, tant qu’ils viennent avant de commencer à appeler les fonctions plotly.
Données :
Lorsque vous envoyez des données de l’API MATLAB, vous envoyez fondamentalement objets JSON sur le site plotly. Ces objets suivent une structure très spécifique et organisée, divisée en parties, de données et mise en page.
Le composant de données est en fait un tableau avec toutes les données trace infos, comme par exemple des points X, Y et Z, ainsi que les paramètres pour le graphique lui-même, comme le type de graphique et le style.
Pour envoyer des infos données à partir de MATLAB à plotly, nous pouvons utiliser une fonction API appelée plotly(). Dans mon cas, j’ai envie d’envoyer les données de x, où X est un tableau, essentiellement avec la longueur de l’axe des X (40 m de chaque côté, étant 0 au centre), les données de y, où Y est également un tableau, mais avec la hauteur de la zone (par rapport au sol de 50 m de haut) et les données de z, qui dans mon cas peut être la matrice « K » ou « C » (pour les valeurs électriques et magnétiques respectivement). En outre, j’enverrai aussi des informations sur le type de graphique, je veux, dans ce cas, c’est un « heatmap » et la couleur que j’aime, mise à l’échelle qui est définie dans le champ « scl ». Donc ces est ce que je dois écrire :
>>> ETRUBANS = struct ('x', X, 'y', Y, 'z', C, 'type', « heatmap »,...
'scl',{{{0,'rgb(0,0,131)'},{0.125,'rgb(0,60,170)'}...
{0.375,'rgb(5,255,255)'},{0.625,'rgb(255,255,0)'},...
{0.875,'rgb(250,0,0)'},{1,'rgb(128,0,0)'}}},...
'showscale', false)
>>> plotly ({ETRUBANS}, struct ('NomFichier', nameM, 'fileopt', 'écraser'))
La fonction plotly vous permet également de déterminer le nom du fichier graphique que vous créez sur votre galerie plotly, et si vous créez un nouveau fichier ou écraser un existant. Ils sont réalisés avec les champs « NomFichier » et « fileopt ». Dans mon cas, la variable « nameM » est une chaîne contenant le nom, que je veux que le graphique d’avoir.
La fonction plotly() renvoie une réponse du site plotly qui devrait ressembler à ceci :
URL: « https://plot.ly/~joaoduarte/8 »
message: [1 x 0 char]
AVERTISSEMENT: [1 x 0 char]
nom de fichier: "champ électrique pour t = 6,667 ms'
erreur: [1 x 0 char]
Après que vous avez reçu cette réponse, votre graphique est prêt sur votre galerie plotly !
Dans mon cas, je vous envoie beaucoup de points de données avec cette API, donc pour vous donner une idée, il prend mon ordinateur près d’une minute pour calculer tous et de les envoyer à plotly. Si cette réponse peut prendre un peu à recevoir.
Mise en page :
Maintenant, la partie mise en page est essentiellement un objet avec les paramètres de présentation graphique global supplémentaire, comme le titre du graphique, les étiquettes d’axe, annotations spéciales, entre autres choses. Pour envoyer des infos de mise en page de l’API plotly de MATLAB, vous pouvez utiliser la fonction plotlylayout().
Dans mon cas, je vais utiliser cette fonctionnalité pour donner le graphe un titre, à l’étiquette du X et axe des Y et aussi de mettre le nom de fichier comme une annotation sous le graphique. Je vais devoir écrire ces lignes :
>>> layoutM = struct ("title", « Distribution Spacial de champ magnétique »,...
« xaxis », struct ('title', 'Axe des X [m]')...
« yaxis », struct ('title', 'Axe des Y [m]')...
« annotations », {{struct ('text', nameM...
« xref », « papier », « yref », « papier »...
'x', 0, 'y', -0,15, 'coin', 'gauche'...
'showarrow', false)}})
>>> plotlylayout(layoutM)
La fonction plotlylayout() retourne également une réponse comme ceci :
URL: « https://plot.ly/~joaoduarte/8 »
message: [1 x 0 char]
AVERTISSEMENT: [1 x 0 char]
nom de fichier: "champ électrique pour t = 6,667 ms'
erreur: [1 x 0 char]
Comme avant, cela signifie que votre nouveau graphique est prêt dans votre galerie !
Informations additionnelles :
La structure particulière de l’objet JSON peut être un peu déroutant au début, et vous devez respecter pour l’API fonctionne correctement. En cas de doute, vous devriez vérifier la documentation de l’API pour plus d’informations sur les paramètres spécifiques de chaque fonction, règles et autres fonctionnalités que je n’ai pas utilisé dans cet exemple. Vous pouvez le trouver ici, non seulement pour MATLAB mais aussi pour Python, Arduino, Raspberry PI, entre autres. Pour obtenir des informations générales sur le plotly des objets JSON, consultez la documentation de l’API REST.
Une autre bonne chose à faire, est de vérifier le fichier JSON du graphique, sur votre éditeur de site web plotly. Là, vous pouvez voir ce que vous avez effectivement envoyé ou comment vous devez envoyer les données.
