Aggiunta di librerie al browser delle librerie e inserimento rapido

Apri script

Questo esempio mostra come aggiungere una libreria a Simulink® Library Browser e come configurare un blocco libreria per aggiungerlo al menu di inserimento rapido.

Aggiunta di una libreria al browser delle librerie

Il browser delle librerie visualizza una struttura ad albero delle librerie disponibili sul sistema che è possibile sfogliare per aggiungere blocchi ai modelli.

Per aggiungere una libreria personalizzata al browser delle librerie, seguire questi passaggi:

1. Caricare e sbloccare una libreria esistente myLib. È anche possibile creare una nuova libreria. Per ulteriori informazioni, vedere Create Custom Library.

load_system("myLib")
set_param("myLib","Lock","off")

2. Per visualizzare le annotazioni nel browser delle librerie, aggiungere annotazioni di testo o di immagine nella libreria, quindi fare clic con il tasto destro del mouse su queste e selezionare Show in Library Browser (Mostra nel browser delle librerie). Per informazioni su come impostare le annotazioni in un modello, vedere Annotate Models.

È possibile disporre i blocchi e le annotazioni nella libreria in qualsiasi ordine. Per impostazione predefinita, vengono visualizzati in ordine alfabetico nel browser delle librerie, con i sottosistemi elencati per primi, seguiti dai blocchi e infine dalle annotazioni. Gli utenti della libreria possono utilizzare il menu contestuale del browser delle librerie per passare dall'ordine alfabetico all'ordine specificato. Quando gli utenti selezionano l'ordine specificato, la disposizione nella libreria determina la modalità di visualizzazione nella griglia del browser delle librerie.

3. Nella finestra di comando MATLAB®, inserire questo comando per impostare la proprietà della libreria EnableLBRepository su on.

set_param("myLib","EnableLBRepository","on");

La libreria apparirà nel browser delle librerie solo se questa proprietà è abilitata al momento del salvataggio della libreria.

4. Salvare la libreria in una cartella nel percorso di MATLAB o aggiungere la sua posizione al percorso di MATLAB.

save_system("myLib");

5. Per specificare come deve apparire la libreria personalizzata nel browser delle librerie, seguire questi passaggi:

  • Creare un nuovo script slblocks nella cartella che contiene la libreria personalizzata.

  • Aggiungere questa funzione per specificare che la libreria personalizzata myLib apparirà con il nome My Library nel browser delle librerie:

function blkStruct = slblocks
Browser.Library = "myLib";
Browser.Name = "My Library";
blkStruct.Browser = Browser;

  • Salvare slblocks. È possibile salvare il file come file .m o .mlx, ma non come file P-code.

6. Per aprire il browser delle librerie, fare clic sul browser delle librerie nella barra degli strumenti di Simulink.

7. Per visualizzare la nuova libreria nel browser delle librerie, fare clic con il tasto destro del mouse sull'elenco delle librerie nel browser delle librerie e selezionare Refresh Library Browser (Aggiorna browser delle librerie).

Nota: se si salva una libreria personalizzata senza aver impostato EnableLBRepository su on, verrà visualizzato un messaggio nella parte superiore del browser delle librerie. Fare clic su Fix (Correggi) e rispondere al prompt in modo appropriato.

Aggiunta di sottolibrerie alla libreria

Se la libreria contiene diversi blocchi, è possibile migliorarne l'organizzazione raggruppando i blocchi correlati in blocchi Subsystem separati per creare sottolibrerie.

Per creare una sottolibreria nella libreria myLib, seguire questi passaggi:

  1. Aggiungere un blocco Subsystem denominato Basic Signals.

  2. All'interno di Basic Signals, eliminare i blocchi Inport e Outport predefiniti. Se le porte di input e di output di tutti i blocchi all'interno di un blocco Subsystem sono collegate, il blocco Subsystem viene considerato un blocco libreria riutilizzabile e non una libreria referenziata.

  3. Aggiungere i blocchi Step, Ramp e Sin all'interno del blocco Basic Signals.

  4. Opzionalmente, è possibile creare una maschera per il blocco Subsystem per visualizzare testo o un'immagine che illustri lo scopo della libreria. Tuttavia, la maschera può avere solo un'icona. Se si aggiunge codice o parametri nella maschera del blocco Subsystem, il blocco Subsystem verrà considerato un blocco libreria riutilizzabile e non una libreria referenziata.

  5. Salvare myLib.

  6. Per visualizzare la sottolibreria nel browser delle librerie, fare clic con il tasto destro del mouse sull'elenco delle librerie e selezionare Refresh Library Browser (Aggiorna browser delle librerie).

Considerazioni durante l'utilizzo delle sottolibrerie

  • Se il nome del blocco Subsystem contiene la parola Examples (Esempi), scritta in maiuscolo come mostrato, il browser delle librerie visualizzerà il sottosistema come un blocco piuttosto che come una sottolibreria.

  • Se si crea una gerarchia di sottosistemi in una libreria, è necessario utilizzare nomi di sottosistemi univoci. Ad esempio, non creare una gerarchia come SubsystemA/SubsystemB/SubsystemA.

Impostazione dell'ordine delle librerie nell'elenco delle librerie

È possibile organizzare l'ordine in cui appare la propria libreria rispetto ad altre librerie nel browser delle librerie. Per impostazione predefinita, la libreria Simulink appare in cima all'elenco con una priorità di ordinamento pari a -1. Le altre librerie hanno una priorità di ordinamento pari a 0 e appaiono quindi sotto la libreria Simulink. Per posizionare la propria libreria in cima all'elenco, impostare la priorità di ordinamento su -2. Le librerie con la stessa priorità di ordinamento vengono disposte in ordine alfabetico.

Per impostare la priorità di ordinamento di una libreria, aggiungere un file sl_customization.m al percorso di MATLAB. Questo contenuto esemplificativo di sl_customization posiziona la libreria My Library in cima all'elenco delle librerie:

function sl_customization(cm)
cm.LibraryBrowserCustomizer.applyOrder({'My Library',-2});
end

Per applicare immediatamente la personalizzazione, utilizzare questo comando nella finestra di comando MATLAB:

sl_refresh_customizations

Aggiunta di blocchi libreria al menu di inserimento rapido

È possibile aggiungere parole chiave a un blocco nella libreria e utilizzarle per inserire blocchi libreria in un modello dal menu di inserimento rapido. Il menu di inserimento rapido consente di aggiungere blocchi direttamente a un modello senza uscire dall'area di disegno. È sufficiente fare clic sull'area di disegno per aprire il menu di inserimento rapido e iniziare a digitare la parola chiave o il nome del blocco per aggiungere i blocchi.

Per aggiungere parole chiave a un blocco in una libreria personalizzata, seguire questi passaggi:

1. Utilizzando la funzione set_param, impostare il parametro BlockKeywords del blocco Gain:

set_param('myLib/Gain','BlockKeywords',["My Gain", "Your Gain"])

2. Salvare la libreria.

save_system("myLib")

3. Eseguire il refresh del browser delle librerie per aggiornare il menu di inserimento rapido con le nuove parole chiave.

4. Ora è possibile aggiungere il blocco Gain al modello digitando il nome del blocco o una delle parole chiave nel menu di inserimento rapido.

Considerazioni durante l'utilizzo dell'inserimento rapido

  • I caratteri speciali supportati nelle parole chiave sono '&', '(', ')', '+', '@' e '!'.

  • Non è possibile aggiungere parole chiave ai blocchi dai blocchi comunemente utilizzati poiché si tratta di una posizione in cui visualizzare i blocchi utilizzati di frequente da varie librerie. Se si desidera aggiungere parole chiave a un blocco disponibile nei blocchi comunemente utilizzati, è necessario aggiungerle nella libreria in cui è definito il blocco.

  • Il menu di inserimento rapido supporta la ricerca dei blocchi utilizzando parole chiave in lingue diverse dall’inglese, grazie all'utilizzo di parole chiave internazionalizzate.

Vedi anche

Strumenti

Argomenti