Estendere Rialto. Esercitazione Data Mining 5 Novembre

Transcript

1 Estendere Rialto Esercitazione Data Mining 5 Novembre

2 Obiettivi Mostrare come sia possibile sviluppare i propri moduli per estendere il tool

3 Estendere Rialto Rialto si configura come un tool di Data Mining a Plugins E possibile quindi scrivere il proprio E possibile quindi scrivere il proprio modulo (Acquisition Task, Filter Task, Model, etc.) e facilmente pluggarlo nel framework

4 Rialto SDK Per lo sviluppo di un nuovo plugin è possibile utilizzare come punto di avvio il progetto java caricato nella sottocartella Reference/Examples all interno della Rialto SDK. Questo esempio fornisce le componenti necessarie per il corretto sviluppo di un plugin, ossia: build.xml è uno script Ant che può essere usato per editare, testare ed eseguire la build del plugin;.classpath and.project.settings/org.eclipse.jdt.core.prefs definiscono le preferenze per la compilazione delle classi del plugin. E importante notare che la cartella src/main/java della cartella dell esempio è riempita con alcuni esempi di plugins, mentre src/test/java contiene le rispettive classi di test.

5 Plugin stateless e statefull In Rialto esistono 2 tipologie di plugin: Stateless, sono esecutori di compiti, come la manipolazione dei dati (es. filtri) Statefull, conservano informazioni come il modello estratto (es. modelli di mining) N.B. affinché un modello possa mantenere informazione e salvato gli oggetti contenuti al suo interno devono fornire un metodo costruttore con tutti i campi necessari per la sua corretta ricostruzione e preceduto dal Questo non è necessario per tipi primitivi

6 Esempio private Info { info" }) public MyDataStructure(final Info info) { this.info = info; } public Info getinfo(){ return info; }

7 Estendere Rialto: esempio Nella lezione sull analisi dei dati medici, si era individuata la necessità di utilizzare un filtro che combinasse 2 campi del dataset in esame Per risolvere questo problema si era deciso di utilizzare SQL Filter E tuttavia possibile scrivere un filtro dedicato proprio per questo tipo di operazioni

8 Creare Un Filtro Obiettivo: Creare un filtro aritmetico, che prenda in input una tabella e restituisca in output la stessa tabella contenente una nuova colonna il cui valore è la somma od il prodotto di altri due 2 attributi selezionati dalla tabella dei parametri N.b. I 2 attributi alla fine del processo saranno rimossi

9 Implementazione Si crea una nuova Classe ArithmeticFilter Poiché il filtro ha un solo ingresso e una Poiché il filtro ha un solo ingresso e una sola uscita questa classe estenderà Abstract1to1TableFilterTask

10 Definizione dei parametri I parametri necessari per lo sviluppo del plugin sono 3: L indice della prima colonna; L indice della seconda colonna; L operatore aritmetico da utilizzare.

11 Specificare un parametro I parametri del plugin che si sta progettando sono particolari oggetti detti PluginParameter E necessario aggiungere tanti PluginParameter quanti sono i parametri del plugin

12 Creazione dei parametri public final PluginParameter<Integer> att1index = createparameter(); public final PluginParameter<Integer> att2index = createparameter(); public final PluginParameter<Operator> operator = createparameter();

13 Annotazione dei parametri In Rialto è possibile inserire delle annotazioni sui parametri al fine di specificare informazioni o comportamenti particolari dei parametri Questa possibilità risulta utile anche nel semplice caso in esame

14 Annotazioni sui parametri Si consideri il primo parametro, possono essere aggiunte le seguenti of attribute Types = { AttributeType.INTEGER, AttributeType.DOUBLE public final PluginParameter<Integer> att1index = createparameter();

15 Descrizione delle : Permette di settare il nome del parametro che sarà poi visualizzato nella tabella dei : Permette di inserire una descrizione dei parametri che sarà visualizzata nella Permette di specificare i tipi dei campi permessi per quel parametro (Nel caso in esame : Permette di specificare che è possibile anche un valore null come valore di default per il parametro. In tal senso il settaggio del parametro è rimandato alla fase di deploy.

16 Osservazioni All atto di creazione del parametro è necessario specificare il tipo del parametro: PluginParameter<Integer> Il secondo parametro si comporta in maniera analoga al primo, in quanto ambedue permettono di selezionare un indice della tabella

17 Il parametro per la scelta dell operatore Definiamo dapprima un enumeration public enum Operator { } MULTIPLY, SUM Il tipo che specificheremo per il PluginParameter è Operator

18 PluginParameter sums and multiplications can be performed") public final PluginParameter<Operator> operator = createparameter();

19 Costruttore Nel Costruttore l unica operazione che è eseguita è il settaggio di un valore di default per il parametro operator: public DummyArithmeticFilter() { operator.setdefaultvalue(operator.sum); }

20 Metodi da implementare Per avere un corretto comportamento del filtro deve essere eseguito l override di alcuni metodi: gettargetmetadata; _executeinterruptibly.

21 gettargetmetadata Il metodo in esame permette di specificare come ricostruire i metadati che saranno settati per la tabella di output generata dal filtro: public TableMetadata gettargetmetadata() L oggetto TableMetadata non sono altro che i metadati ricostruiti per la tabella!

22 Implementazione final TableMetadata metadata = getinputmeta(); final TableMetadataBuilder builder = metadata.createbuilder(); builder.remove(metadata.getattribute(geta tt1index())); builder.remove(metadata.getattribute(geta tt2index())); builder.add(new DoubleAttribute("Operation result")); return builder.build();

23 Analisi del codice final TableMetadata metadata = getinputmeta(); Con questa operazione vengono restituiti i metadati della tabella data in input al task final TableMetadataBuilder builder = metadata.createbuilder(); Con questa operazione viene creato un Builder per i metadati, con esattamente gli stessi campi della tabella in input; builder.remove(metadata.getattribute(ge tatt1index())); Con questa operazione si rimuove dai metadati della tabella di output l indice della colonna che l utente ha specificato nel primo parametro

24 Analisi del codice builder.remove(metadata.getattribu te(getatt2index())); Con questa operazione si rimuove dai metadati della tabella di output l indice della colonna che l utente ha specificato nel secondo parametro builder.add(new DoubleAttribute("Operation result")); Con questa operazione si aggiunge in coda alla tabella una nuova colonna ossia il nuovo campo derivato di interesse

25 _executeinterruptibly Il metodo in esame permette di specificare come riempire i dati della tabella generata dal filtro: protected void _executeinterruptibly(final TaskExecutionSupport taskexecutionsupport) throws InterruptedException

26 _executeinterruptibly Questo metodo sarà invocato automaticamente all esecuzione del task E passato come parametro un oggetto TaskExecutionSupport per permettere a colui che sviluppa il plugin di gestire l interruzione dell esecuzione nel caso che l utente decida di stoppare il task da Interfaccia

27 Implementazione final WriteableTable outtable = getoutputtable(); Tabella di output di sola scrittura final ReadableTable intable = getinputtable(); Tabella di input sulla quale possiamo leggere

28 Implementazione //Scorriamo la tabella di input for (final ReadableRow inrow : intable) { //Aggiungiamo una nuova riga vuota alla //tabella final ReadWriteRow outrow = outtable.getnewrow(); //Inizializziamo gli indici int outindex = 0; double value1 = 0; double value2 = 0;

29 Implementazione //Scorriamo gli indici delle colonne e riempiamo la riga con gli opportuni valori for (int inindex = 0; inindex < intable.getnumattributes(); inindex++) { if (inindex == getatt1index()) { value1 = inrow.getvalue(inindex); } } else if (inindex == getatt2index()) { value2 = inrow.getvalue(inindex); } else { outrow.copyrowvalue(outindex++, inrow, inindex); }

30 Implementazione //Settiamo il valore della //nuova colonna } final double result = evaluateresult(value1, value2); outrow.setvalue(outindex, result); outtable.appendrow(outrow);

31 Metodi di utilità protected double evaluateresult(final double val1, final double val2) { if (getoperator() == Operator.SUM) { return val1 + val2; } return val1 * val2; } protected int getatt1index() { return att1index.getvalue(); } protected int getatt2index() { return att2index.getvalue(); } protected Operator getoperator() { return operator.getvalue(); }

32 Operazioni di deploy del plugin Come ultima operazione è necessario modificare il file xml di configurazione aggiungendo la nuova extension nella sezione dei filtri: <es:extensionpoint> <es:name>nomedelnuovofiltro</es:name> <es:class>.class</es:class> </es:extensionpoint>

33 Utilizzo E ora possibile trascinare il nuovo filtro dall Extension Viewer nell area di lavoro: Task -> Filter -> NomeDelFiltro Selezionandolo, la relativa tabella dei parametri viene visualizzata all utente

34 Dipendenze fra i parametri E possibile introdurre dipendenze dai parametri: È possibile infatti che in alcuni casi dei È possibile infatti che in alcuni casi dei parametri diventino ininfluenti per la corretta esecuzione del plugin e che sia per cui disattivati da interfaccia

35 Esempio Supponiamo di avere 2 PluginParameters parameter1 e parameter2 L obiettivo e quello di disattivare parameter1 se parameter2 assume un particolare valore (per semplicità assumiamo che questi valori varino tra i valori di un enumeration come nel caso dell operator visto in precedenza)

36 Esempio Il codice per aggiungere questo vincolo deve essere inserito nel costruttore della classe: parameter1.dependson(parameter2. beingoneof(parameter2.enumeratio nvalue));