Tabelle: sottocomandi e configurazione

E’ possibile passare ulteriori sottocomandi all’interno del blocco (do...end) di comandi di una tabelle.

show

Il parametro show impostato a false impedisce il render della tabella nell’output html, pdf e xlsx. E’ anche possibile far seguire all’istruzione che produce la tabella un underscore (_) o utilizzare show_ all’interno del blocco di codice della tabella.

1
2
3
4
5
6
 cat :d1, "TAB.1", :show => false
 cat_ :d2, "TAB.2"
 ord :d5, "TAB.2" do
   w 0=>7, 1=>2.5, 2=>1, 3=>0.5, 4=>0.25
   show_
 end

vars e title

I parametri vars e title possono anche essere sostituiti dalle funzioni con lo stesso nome all’interno del blocco di codice della tabella. In tal caso, in vars, non è necessario racchiudere le liste di variabili tra parentesi quadre. Vedi anche $var_label().

1
2
3
4
 md do
   vars :d7_1, :d7_2, :d7_3, :d7_4, :d7_5
   title "D7. Titolo"
 end

titles

Inserisce delle etichette esplicite per le variabili in fiancata. Usare una stringa vuota o nil se non si vuole etichettare una variabile.

1
2
3
4
5
6
 cat [:d1, :d2] do
   titles "Etichetta D1", "Etichetta D2"
 end
 cat [:d1, :d2] do
   titles nil, "Etichetta D2"
 end

note, footnote, corner

Aggiungono delle note di testo alla tabella:

  • note: nota della sezione
  • footnote: nota della tabella
  • corner: nota nell’angolo in alto a sinistra della tabella
1
2
3
4
 md s(:d7_, 10), "D7. Multipla + sort" do
   sort :d
   note "Dati ordinati per frequenze decrescenti"
 end

w

Per ord, scale, fred o desc assegna dei pesi alle modalità delle variabili.

I pesi devono essere indicati attraverso un hash secondo il formato codice => peso. Nel caso venga fornito solo un elenco (array) di pesi, i pesi verranno associati ai valori della variabile in ordine crescente.

Il parametro di configurazione :wlegend determina se mostrare una nota automatica che descrive i pesi. Il testo della legenda è determinato dal parametro di configurazione weight_legend_label. Il simbolo inserito al posto di un peso nil è determinato dal parametro di configurazione nil_weight_legend.

Oltre al codice è possibile indicare:

  • [1,2,3]: un vettore di codici
  • 1..3: un intervallo di interi
  • :else: indica tutti i livelli non specificati

Oltre al valore del peso è possibile indicare:

  • nil|:na|NA: per escludere il codice dal calcolo
  • :copy: indica che deve essere utilizzato come valore il codice
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
 ord :d5, "D5. Distribuzione di frequenza più valori medi con pesi" do
   w 0=>7, 1=>2.5, 2=>1, 3=>0.5, 4=>0.25
 end

 scale s(:x9,10), "Tabella 9." do
   w (1..10).to_a << :na                 # <= ovvero: 1,2,3,4,5,6,7,8,9,10,nil
 end

 ord :v100 do
   w [0,9,99]=>:na, :else=>:copy
 end

Suggerimento

E’ possibile definire i pesi direttamente nelle proprietà della variabile con l’istruzione weights.

wght

Nelle tabelle ord permette di indicare le variabili per il calcolo delle statistiche descrittive.

Il numero di variabili indicate deve corrispondere al numero di variabili della tabella, oppure deve essere indicata una sola variabile che verrà utilizzata per tutte le variabili della tabella.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
 ord :d5, "Title"
   wght :r5
 end

 ord [:v1, :v2, :v3], "Title"
   wght :x1, :x2, :x3
 end

 ord [:v1, :v2, :v3], "Title"
   wght :x1
 end

codes

Nelle tabelle tbox specifica i codici che devono essere raggruppati e conteggiati. Può essere specificato come sottocomando o nelle opzioni.

1
2
3
4
5
6
 tbox s(:d6_,10), "Tabella 6 - Quanto sono importanti per Lei questi aspetti? (TOP BOX)" do
   codes 1,2
   sort :d
 end

 tbox s(:d6_,10), "Tabella 6 - Quanto sono importanti per Lei questi aspetti? (TOP BOX)", :codes => [1,2]

missed

Specifica i livelli delle variabili di riga che devono essere escusi dalla tabulazione nelle tabelle cat e ord.

Inserendo l’argomento :note, verrà generata una nota automatica che riporta le etichette degli item esclusi (utilizza le etichette della prima variabile). Il testo della nota è determinato dal parametro di configurazione note_missed.

1
2
3
 cat :v10 do
   missed 8, 9, :note
 end

sort

Ordina le righe secondo le numerosità delle frequenze. :a ascendente, :d discendente. Come secondo parametro si può specificare la statistica su cui calcolare l’ordinamento oppure :label per avere l’ordinamento sulle etichette dei livelli: il default è :count. Specificando :rev, le righe vengono ordinate in senso inverso.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
 md s(:d7_, 10), "D7. Multipla + sort" do
   sort :d
   note "Item ordinati per frequenze decrescenti"
 end
 md s(:d7_, 10), "D7. Multipla + sort" do
   sort :a, :label
   note "Item ordinati alfabeticamente"
 end
 scale s(:d6_, 10) do
   sort :a, :mean
   note "Item ordinati sui valori medi"
 end
 cat d1, "D1" do
   sort :rev
   note "Item ordinati in senso inverso"
 end

fixed

In caso di ordinamento, specifica gli item che devono rimanere in fondo. Specificare un numero negativo indicante il numero di item a partire dall’ultimo che devono essere tenuti fissi. Tenere eventualmente conto dell’item aggiunto dal sottocomando none.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
 md s(:d7_,1..10,98,99), "D7. Multipla" do
   sort :a
   fixed -2
   noresp -2          # gli item 11 e 12: d7_98 e d7_99
 end

 md s(:d7_,10), "D7. Multipla" do
   none "Nessuna citazione"
   sort :a
   fixed -1           # l'item 11, quello generato da 'none'
 end

keep e drop

Seleziona le righe da mostrare in una tabella, elencando le righe da tenere oppure quelle da eliminare. keep e drop agiscono dopo il calcolo della tabella, quindi la base e il calcolo delle percentuali rimane invariato. Agiscono però prima di sort e dell’eventuale calcolo dei net, quindi si riferiscono sempre ai livelli originali e al loro ordine.

1
2
3
4
5
6
7
 md s(:d7_, 10) do
   keep 4..6, 10
 end

 cat :d1 do
   drop 6
 end

hide

Elimina le righe della tabella finale. hide agisce al momento della stampa della tabella, dopo che sono state applicate tutte le precedenti trasformazioni (keep, drop, sort, first, last, net, ecc.).

1
2
3
 cat :v200 do
   hide 1..4
 end

exclude

In camp e cbyc permettono di escludere le variabili indicate dalla tabella.

1
2
camp :exclude => :tot
cbyc :exclude => [:x1, :x100]

base

Permette di specificare esplicitamente i casi su cui calcolare le percentuali. Indicare il nome di una variabile, verranno considerati come base i casi validi della variabile.

1
2
3
md s(:d7_, 10), "D7" do
  base :base7
end

noresp

Nelle md dichiara le variabili che non devono essere conteggiate nel numero medio delle risposte. E’ possibile indicare i nomi delle variabili oppure un numero positivo (numero di variabili a partire dalla prima) o positivo (numero di variabili a partire dall’ultima).

1
2
3
4
5
6
7
 md s(:d7_, 10,98,99), "D7. Multipla" do
   noresp :d7_98, :d7_99
 end

 md s(:d7_, 10,98,99), "D7. Multipla" do
   noresp -2
 end

none

Nelle tabelle cat e ord, quando è attivato base_colpct :all, aggiunge il conteggio delle osservazioni che non hanno risposta sulla variabile.

1
2
3
4
5
 base_colpct :all
 ord :d5, "D5. Titolo" do
   w :legend, 5, 4, 3, 2, 1
   none "(non pertinente)"
 end

Nelle md aggiunge il conteggio delle osservazioni che non hanno attivato nessun item. Questa voce non viene conteggiata nel numero medio delle risposte.

none conteggia i casi che non hanno attivato nessuna citazione nel set di variabili. Vengono conteggiati solo i record che hanno valore valido sulla prima variabile o quelli della base definita con il sottocomando base.

Il valore utilizzato per considerare un item attivato e e il valore generato nella nuova variabile è quello definito dalle istruzioni md_ft o md_tf (default 1).

none ha un’etichetta e degli stili predefiniti nei parametri di configurazione: label_na, na_bold, na_italic.

1
2
3
4
5
6
7
 md s(:d7_,10) do
   none
 end

 md s(:d7_,10), "D7+NONE" do
   none "NESSUNA CITAZIONE"
 end

all

Nelle md aggiunge il conteggio delle osservazioni che hanno attivato almeno un item. Questa voce non viene conteggiata nel numero medio delle risposte.

Il valore contato e quello generato nella nuova variabile è quello definito dalle istruzioni md_ft o md_tf (default 1).

all ha un’etichetta e degli stili predefiniti nei parametri di configurazione: label_all, all_bold, all_italic.

1
2
3
4
5
6
7
8
 md s(:d7_,10) do
   all
 end

 md s(:d7_,10), "D7+ALL+NONE" do
   all "TOTALE CITAZIONI"
   none "NESSUNA CITAZIONE"
 end

nresp e mresp

Nelle md e mc, i parametri nresp e mresp attivano rispettivamente il calcolo del numero delle risposte e del numero medio delle risposte.

mresp è calcolato come il rapporto tra il numero totale di citazioni e il numero di casi che hanno fornito una citazione valida.

1
2
 mresp!
 nresp!

Avvertimento

Eventuali item che conteggiano le osservazioni che non hanno citazioni (per esempio la voce “Nessuna di queste” nella domanda sul ricordo delle marche), se inseriti come semplici variabili verranno conteggiati nel numero delle risposte. Pertanto, se si utilizza nresp! e/o mresp!, dichiarare l’item da escludere tramite il sottocomando noresp, oppure usare il sottocomando none per calcolare le mancate risposte.

calc

calc permette di specificare delle formule che saranno applicate a una specifica riga. Le righe sono sono numerate progressivamente a partire da 1 (primo item).

Per la sintassi delle formule vedi Pannnelli>panel(n).compute, panels.compute

1
2
3
4
5
6
7
8
9
add_levels :v1 => {3 => "DELTA"}
ord :v1 do
  compute 3 => {:all => "1r-2r"}
end

int :v2_3, 1, "DELTA"
md s(:d2_,3) do
  calc 3 => {:count => "1r-2r", :else => nil}
end

Parametri di configurazione

base_colpct

Il parametro base_colpct permette di impostare la base per il calcolo delle percentuali di colonna.

Valori:

  • :table: (il default) calcola le percentuali sui casi validi della variabile di fiancata
  • :all: calcola le percentuali sul totale casi o, nel caso sia impostato un filtro, sul totale casi selezionati
1
2
 base_colpct :all
 cat :d1

base_multi

Il parametro base_multi permette di impostare il metodo di calcolo delle percentuali di colonna nelle multidicotomy.

Valori:

  • :cases: (il default) calcola le percentuali rispetto ai casi validi (valori diversi da blank) di tutta la batteria di variabili
  • :resp: calcola le percentuali sul totale delle risposte
  • :all: calcola le percentuali sul totale casi
  • :var: calcola le percentuali sui casi validi di ciascuna variabile di fiancata

base_tbox

Il parametro base_tbox permette di impostare il metodo di calcolo delle percentuali di colonna nelle tabelle tbox.

Valori:

  • :table: (il default) calcola le percentuali sui casi validi (valori diversi da blank) di tutta la batteria di variabili
  • :var: calcola le percentuali sui casi validi di ciascuna variabile di fiancata