Parametri di configurazione¶

La configurazione di pTabs è controllata da una serie di parametri. Tutti i parametri hanno già un valore di default che può essere sufficiente per i casi più comuni. E’ possibile modificare i file di configurazione oltre che modificare i vari parametri all’interno dello script.

La modifica dei parametri relativi al calcolo e al layout delle tabelle hanno effetto solo sulle tabelle successive.

I parametri logici (true|false), vengono attivati e disattivati negli script con la sintassi: parametro! e parametro_. Per i restanti parametri, si passa l’argomento dopo il nome del parametro.

parametro? stampa e restituisce il valore correntemente impostato del parametro.

 rowpct!           # attiva la visualizzazione delle percentuali di riga
 sd_               # disattiva la visualizzazione della deviazione standard
 frm_mean {:p=>3}  # imposta tre decimali nel formato delle medie
 net_pos?          # stampa nel log il valore del parametro 'net_pos'

Parametri¶

Configurazione¶

Parametro Tipo Default Descrizione

add_load_path Array [] Vettore con percorsi aggiuntivi di ricerca dei file di risorse

check_new_version_hh Fixnum 4 Numero di ore di intervallo per controllare la presenza di una nuova versione di pTabs. 0 per non effettuare mai il controllo

Nomi variabili¶

Parametro Tipo Default Descrizione

dot_to_underscore Boolean false Converte il punto (.) nei nomi di variabile in underscore (_)

underscore_to_dot Boolean false Converte l’underscore (_) nei nomi di variabile in punto (.)

vars_to_lower_case Boolean true Converte in minuscolo i nomi di variabile

Pannelli¶

Parametro Tipo Default Descrizione

join_col_labels Boolean true Unisce le colonne sotto un’unica etichetta quando variabili consecutive hanno la stessa variable label

single_panel Boolean false Unisce i pannelli in un pannello unico

weights_vars_action Symbol :message Comportamento in caso di non corrispondenza dei pesi: :error, :message, :none

Fiancate¶

Parametro Tipo Default Descrizione

join_row_labels Boolean true Inserisce una sola volta l’etichetta della variabile quando variabili consecutive hanno la stessa variable label

varlabel Boolean false Stampa le etichette delle variabili

total_after Boolean false Totale in fondo alla tabella

totals Symbol :all Totali di riga per tutte le variabili o una volta sola per tabella: :all, :one

rowlevel String nil Stampa solo righe di livello minore o uguale (1 = righe senza rientro; 2 = righe con un rientro, ecc.)

scale_style Symbol :compact Stile tabelle scale: :compact, :long

Net¶

Parametro Tipo Default Descrizione

net_pos Symbol :before Posizione net: :before, :after, :top, :bottom

netonly Boolean false Stampa solo i net

netstyle Boolean true Distingue graficamente i net dagli altri item

Basi¶

Parametro Tipo Default Descrizione

base_pct Symbol :table Metodo di calcolo delle percentuali di colonna: :table, :all

Set di variabili¶

Parametro Tipo Default Descrizione

base_multi Symbol :cases Metodo di calcolo delle percentuali di colonna nelle multiple: :cases, :resp, :all

md_true_value Fixnum 1 Valore da contare nelle multidicotomy (“citato”). Vedere anche md_ft e md_tf

md_false_value Fixnum 0 Valore “non citato” nelle multidicotomy. Vedere anche md_ft e md_tf

sets_display Boolean false Set di variabili: stampa set trovati

sets_all Boolean false Set di variabili: cerca tutti i set di variabili, non solo i set di multiple

sets_start String "[a-zA-Z]+" Set di variabili: caratteri di inizio (espressione regolare)

sets_sep String "[_.]" Set di variabili: caratteri separatori (espressione regolare)

sets_pref Array ["m_", "s_"] Set di variabili: prefissi per i nomi di set: multiple e singole

Pesi¶

Parametro Tipo Default Descrizione

weight_legend_label String "Pesi:" Testo iniziale della legenda dei pesi

nil_weight_legend String "n.a" Simbolo inserito al posto di un peso nil nella legenda in fondo alla tavola

nil_weight_label String "-" Simbolo inserito al posto di un peso nil nelle etichette

Zero e basse numerosita’¶

Parametro Tipo Default Descrizione

zero String "-" Carattere che sostituisce lo zero nelle celle

zerorow Boolean true Mostra le righe della tabella con zero casi

empty_table Symbol :message Comportamento per tabelle con 0 casi: :print, :message, :none

empty_table_msg String "La tabella e' vuota" Messaggio per le tabelle con 0 casi

low_values Symbol :weight Considera il numero di casi ponderati (:weight) o grezzi (:raw)

low_table Symbol :print Comportamento per tabelle con numero basso di casi: :print, :message, :none

low_table_msg String "La tabella non contiene un numero significativo di casi" Messaggio per le tabelle con numero basso di casi

low_table_count Fixnum 3 Numero di casi per considerare una tabella come tabella con numero basso di casi

low_cell Symbol :print Comportamento per celle con numero basso di casi: print, :hide

low_cell_label String "***" Etichetta per celle con numero basso di casi

low_cell_count Fixnum 3 Numero di casi per considerare una cella come cella con numero basso di casi

Statistiche¶

Parametro Tipo Default Descrizione

rtotal Boolean true Totale di riga

tcount_u Boolean false Totale valori assoluti non ponderati

tcount Boolean true Totale valori assoluti

tcolpct Boolean false Totale percentuali riga

trowpct Boolean true Totale percentuali colonna

count_u Boolean false Valori assoluti non ponderati

count Boolean true Valori assoluti

rowpct Boolean false Percentuali riga

colpct Boolean true Percentuali colonna

base_u Boolean false Base non pesata

base Boolean true Base

mean Boolean true Media

sd Boolean true Deviazione standard

se Boolean false Errore standard della media

median Boolean false Mediana

qrt Boolean false Quartili

q0 Fixnum 0 Quartile 0

q1 Float 0.25 Quartile 1

q2 Float 0.5 Quartile 2

q3 Float 0.75 Quartile 3

q4 Fixnum 1 Quartile 4

iqr Boolean false Scarto interquartile

range Boolean false Range, campo di variazione

sum Boolean false Somma

mresp Boolean false Numero medio risposte multiple

nresp Boolean false Numero totale risposte multiple

i_conc Boolean false Indice concentrazione

Etichette¶

Parametro Tipo Default Descrizione

title_template String nil Template per titolo tabella

title_prefix String "" Prefisso per titolo tabella

label_rtotal String "Totale" Etichetta totale di riga

label_ctotal String "TOTALE" Etichetta totale di colonna

label_campione String "CAMPIONE" Etichetta tabella campione

label_freq_count String "N." Etichetta valori assoluti frequenze

label_freq_pct String "%" Etichetta percentuali frequenze

label_count_u String "v.a (no pond.)" Etichetta valori assoluti non ponderati

label_count String "v.a." Etichetta valori assoluti

label_rowpct String "% row" Etichetta percentuali riga

label_colpct String "% col" Etichetta percentuali colonna

label_base_u String "base (no pond.)" Etichetta base non ponderata

label_base String "base" Etichetta base

label_mean String "media" Etichetta media

label_sd String "dev. standard" Etichetta deviazione standard

label_se String "s.e. media" Etichetta errore standard della media

label_median String "mediana" Etichetta mediana

label_q0 String "minimo" Etichetta quartile 0

label_q1 String "1^ quartile" Etichetta quartile 1

label_q2 String "mediana" Etichetta quartile 2

label_q3 String "3^ quartile" Etichetta quartile 3

label_q4 String "massimo" Etichetta quartile 4

label_iqr String "scarto interquartile" Etichetta scarto interquartile

label_range String "range" Etichetta range

label_sum String "somma" Etichetta somma

label_mresp String "N. medio risposte" Etichetta numero totale risposte multiple

label_nresp String "N. risposte" Etichetta numero medio risposte multiple

label_i_conc String "Ind. conc." Etichetta indice concentrazione

label_one_tail String "test a una coda" Etichetta test una coda

label_two_tail String "test a due code" Etichetta test due code

label_corr String "metodo di correzione" Etichetta metodo di correzione

label_yates String "correzione di Yates" Etichetta correzione di Yates

label_sig_level String "livello di significativita'" Etichetta livello di significativita’

label_conf_level String "livello di confidenza" Etichetta livello di confidenza

pc_test_level Symbol :conf :conf => nota con livello di confidenza; :sig => nota con livello di significativita’

index_title String "Indice tavole" Titolo indice

index_link_html String "Indice" Link all’indice (Html)

index_link_xls String "(indice)" Link all’indice (Excel)

table_continues String "( continua )" Etichetta interruzione tabella

note_missed String "Valori mancanti: @" Nota livelli esclusi dalla tabella (missed)

note_omitted String "# casi mancanti: @" Nota livelli esclusi dalla tabella (omitted)

table_note String "" Nota comune a tutte le tabelle seguenti

corner String "" Etichetta nell’angolo in alto a sinistra della tabella

base_pos Symbol :corner Posizione etichetta filtro: :corner, :title, :note, :tnote

Formati¶

Parametro Tipo Default Descrizione

encoding String "iso-8859-15" Script character encoding (solo nel file yml)

dec_sep String "," Separatore decimali

ths_sep String "." Separatore migliaia (nil per nessun separatore)

frm_count Hash {:p=>0} Formato valori assoluti

frm_count_u Hash {:p=>0} Formato valori assoluti non ponderati

frm_pct Hash {:p=>1, :sx=>"%"} Formato percentuali

frm_i_conc Hash {:p=>1} Formato indice concentrazione

frm_base_u Hash {:p=>0} Formato base non pesata

frm_base Hash {:p=>0} Formato base

frm_mean Hash {:f=>:n, :p=>2, :t=>"%H:%M:%S", :d=>"%d-%m-%Y", :dt=>"%d-%m-%Y %H:%M:%S"} Formato media

frm_sd Hash {:f=>:n, :p=>2, :t=>"%H:%M:%S", :d=>"%d-%m-%Y", :dt=>"%d-%m-%Y %H:%M:%S"} Formato deviazione standard

frm_se Hash {:f=>:n, :p=>2, :t=>"%H:%M:%S", :d=>"%d-%m-%Y", :dt=>"%d-%m-%Y %H:%M:%S"} Formato errore standard della media

frm_median Hash {:f=>:n, :p=>1, :t=>"%H:%M:%S", :d=>"%d-%m-%Y", :dt=>"%d-%m-%Y %H:%M:%S"} Formato mediana

frm_q0 Hash {:f=>:n, :p=>1, :t=>"%H:%M:%S", :d=>"%d-%m-%Y", :dt=>"%d-%m-%Y %H:%M:%S"} Formato quartile 0

frm_q1 Hash {:f=>:n, :p=>1, :t=>"%H:%M:%S", :d=>"%d-%m-%Y", :dt=>"%d-%m-%Y %H:%M:%S"} Formato quartile 1

frm_q2 Hash {:f=>:n, :p=>1, :t=>"%H:%M:%S", :d=>"%d-%m-%Y", :dt=>"%d-%m-%Y %H:%M:%S"} Formato quartile 2

frm_q3 Hash {:f=>:n, :p=>1, :t=>"%H:%M:%S", :d=>"%d-%m-%Y", :dt=>"%d-%m-%Y %H:%M:%S"} Formato quartile 3

frm_q4 Hash {:f=>:n, :p=>1, :t=>"%H:%M:%S", :d=>"%d-%m-%Y", :dt=>"%d-%m-%Y %H:%M:%S"} Formato quartile 4

frm_iqr Hash {:f=>:n, :p=>1, :t=>"%H:%M:%S", :d=>"%d-%m-%Y", :dt=>"%d-%m-%Y %H:%M:%S"} Formato scarto interquartile

frm_range Hash {:f=>:n, :p=>1, :t=>"%H:%M:%S", :d=>"%d-%m-%Y", :dt=>"%d-%m-%Y %H:%M:%S"} Formato range

frm_sum Hash {:f=>:n, :p=>2, :t=>"%H:%M:%S", :d=>"%d-%m-%Y", :dt=>"%d-%m-%Y %H:%M:%S"} Formato somma

frm_mresp Hash {:p=>1} Formato numero medio risposte multiple

frm_nresp Hash {:p=>0} Formato numero totale risposte multiple

frm_coord Hash {:p=>6} Formato coordinate

Test¶

Parametro Tipo Default Descrizione

chisq_test Boolean false Attiva/disattiva il test del chi quadrato

chisq_labels Array ["χ²", "df", "Sig."] Etichette: chi-quadrato, gradi di liberta’, significativita’

chisq_formats Array [{:p=>3}, {:p=>0}, {:p=>3}] Formati: chi-quadrato, gradi di liberta’, significativita’

chisq_warning_cel_freq String "* sono presenti valori attesi ≤1, il valore di χ² potrebbe non essere corretto" Avvertimento celle con numerosita’ bassa

pcm_test Boolean false Attiva/disattiva il Pairwise Comparisons test sulle medie

pcm_test_sig Float 0.05 Livello di significativita’ t-test

pcm_test_tails Fixnum 2 2=due code; 1=una coda

pcm_test_adj Symbol :none Metodo di correzione p-value: :holm, :hoch, :homm, :bonf, :bh, :by, :none

label_pcm_test String "pairwise comparisons" Etichetta Pairwise Comparisons

label_note_pcm String "pairwise comparisons medie" Etichetta Pairwise Comparisons per le note

pcm_test_minbase Fixnum 0 Numero minimo di casi per eseguire il test

pcm_test_note Boolean true Attiva/disattiva le note

pcm_pvalues_print Boolean false Stampa p-value nel log

pcp_test Boolean false Attiva/disattiva il Pairwise Comparisons test sulle percentuali (BETA)

pcp_test_sig Float 0.05 Livello di significativita’ t-test

pcp_test_tails Fixnum 2 2=due code; 1=una coda

pcp_test_adj Symbol :none Metodo di correzione p-value: :holm, :hoch, :homm, :bonf, :bh, :by, :none

label_pcp_test String "pairwise comparisons" Etichetta Pairwise Comparisons

label_note_pcp String "pairwise comparisons proporzioni" Etichetta Pairwise Comparisons per le note

pcp_test_minbase Fixnum 0 Numero minimo di casi per eseguire il test

pcp_test_note Boolean true Attiva/disattiva le note

pcp_yates_corr Boolean false Attiva la correzione di Yates (correzione per la continuita’)

pcp_pvalues_print Boolean false Stampa p-value nel log

pc_sep_chr String "" Carattere separatore dei simboli dei test pcm e pcp

pc_skip_first Boolean false Salta la prima colonna nei test pcm e pcp

Analisi Corrispondenze¶

Parametro Tipo Default Descrizione

ca_dims Fixnum 2 Numero dimensioni grafici

ca_plots Boolean true Genera i grafici

ca_plot_frm Symbol :pdf Formato file grafici: :pdf, :png, :wmf

ca_out Boolean true Genera l’output testuale

ca_arrows Array [false, false] Punti (false) o frecce (true). Un valore per X e uno per Y

ca_contrib Array [:relative, :relative] Indicazione dei contributi tramite l’intensita’ dei colori: :none, :absolute, :relative. Un valore per X e uno per Y

ca_mass Array [true, true] Indicazione delle masse come area dei punti. Comunque disabilitato se presenti punti supplementari. Un valore per X e uno per Y

ca_db Boolean true Esporta coordinate nel db

Accentuazioni¶

Parametro Tipo Default Descrizione

phl Boolean false Attiva/disattiva accentuazioni su percentuali colonna o indice di concentrazione

phl_ic Boolean false Calcola accentuazioni in base all’indice di concentrazione e non alle percentuali di colonna

phl_lev Array [10, 20, 30] Vettore con limiti intervalli accentuazioni (max 3)

phl_min Fixnum 0 Numero minimo di casi nella cella

phl_minus Boolean true Calcola accentuazioni anche su scostamenti negativi

mhl Boolean false Attiva/disattiva accentuazioni medie

mhl_lev Symbol :auto Vettore con limiti intervalli accentuazioni medie (max 3); se :auto utilizza 1/3 sdev, 1/2 sdev, 1 sdev

mhl_min Fixnum 0 Numero minimo di casi nella cella

mhl_minus Boolean true Calcola accentuazioni medie anche su scostamenti negativi

Top-line¶

Parametro Tipo Default Descrizione

tl_index Symbol :long Stampa indice: :none, :short, :long

tl_index_title String "Indice" Titolo indice

tl_highlight_base Boolean true Evidenzia le basi che cambiano tra una variabile e l’altra

tl_notitle Boolean false Se tabulare le variabili senza titolo

tl_nodata Boolean true Se tabulare le variabili vuote

tl_alpha Boolean false Se tabulare le variabili alfanumeriche

tl_file_sx String "_top-line" Suffisso per nome di file

tl_maxlev Fixnum 50 Numero massimo di livelli per le distribuzioni di frequenza

tl_join Boolean true Unisce le tabelle con le stesse etichette di livelli

Hole Count¶

Parametro Tipo Default Descrizione

hc_maxlev Fixnum 50 Numero massimo di livelli per le distribuzioni di frequenza

Grafici (HTML, PDF e pTabsWeb)¶

Parametro Tipo Default Descrizione

chr_width Fixnum 700 Larghezza grafico in pixel

chr_height Fixnum 400 Altezza grafico in pixel

chr_legend_pos Symbol :right Posizione legenda: :top|:bottom|:right|:none

chr_caption Boolean true Presenza del titolo all’interno di gruppo di grafici

chr_gauge_options Hash {:redFrom=>0, :redTo=>0, :yellowFrom=>0, :yellowTo=>0, :greenFrom=>0, :greenTo=>0, :minorTicks=>5} Opzioni grafigo gauge

chr_gauge_width Fixnum 200 Larghezza grafico gauge in pixel

chr_gauge_height Fixnum 200 Altezza grafico gauge in pixel

chr_gauge_caption Symbol :top Presenza e posizione titolo grafico gauge all’interno di gruppo di grafici: :top|:bottom|:none

chr_gauge_label Symbol :inner Presenza e posizione label grafico gauge: :inner|:title|:none

palette Array [] Una palette di colori per i grafici

Mappe¶

Parametro Tipo Default Descrizione

map_width Fixnum 800 Larghezza mappa in pixel

map_height Fixnum 600 Altezza mappa in pixel

map_search Boolean false Mostra il riquadro di ricerca

map_search_text String vai ... Testo riquadro di ricerca

map_zoom_control Boolean false Mostra i pulsanti di controllo dello zoom

map_zoom_slider Boolean true Mostra lo slider di controllo dello zoom

map_center Array [45, 10] Centro geografico iniziale

map_scale Boolean true Mostra scala

map_layers_control Boolean true Mostra controllo selezione layers

map_marker_type Symbol :mk :mk (Maki), :fa (Font Awesome)

map_marker_size Symbol :m :s|:m|:l (solo Maki)

map_marker_icons_mk Array ["polling-place", "star", "cross", "circle", "square", "triangle", "circle-stroked", "square-stroked", "triangle-stroked"] Nomi icone per le serie di punti (Maki)

map_marker_icons_fa Array ["check-square-o", "star", "times", "circle", "square", "map-marker", "circle-o", "square-o", "thumb-tack"] Nomi icone per le serie di punti (Font Awesome)

map_layers Hash {"OpenStreetMap"=>"OpenStreetMap", "OpenStreetMap B&W"=>"OpenStreetMap.BlackAndWhite", "Esri WorldStreetMap"=>"Esri.WorldStreetMap", "Outdoors"=>"Thunderforest.Outdoors", "MtbMap"=>"MtbMap", "Cycle"=>"Thunderforest.OpenCycleMap", "Trasporti"=>"Thunderforest.Transport", "Bianco e nero"=>"Stamen.Toner", "Satellite"=>"Esri.WorldImagery"} Layers (map tiles principali)

map_overlays Hash {"Confini"=>"OpenMapSurfer.AdminBounds", "Strade"=>"Stamen.TonerLines", "Nomi"=>"Stamen.TonerLabels"} Overlays (map tiles livelli sovrapponibili)

map_active_layer Fixnum 1 Numero layer principale preselezionato

map_data_name String "Interviste" Nome serie dati principale

map_bound_serie Fixnum 1 Serie su cui centrare la mappa

map_clustered Fixnum 1 Mostra i punti della serie aggregati: # (una specifica serie); :all (tutte le serie); :none (nessuna serie)

map_show_position Boolean false Stampa le coordinate geografiche nel fumetto del punto

map_show_series_info Boolean false Stampa informazioni sulle serie di punti

map_point_label Array ["punto", "punti"] Etichetta ‘punti’

SPSS¶

Parametro Tipo Default Descrizione

spss_use_value_labels Boolean true Converte le variabili con etichette dei valori in factor R

spss_max_levels Fixnum 100 Se :spss_use_value_labels=true : massimo numero di livelli di una variabile categoriale. Le variabili con un numero maggiore di livelli vengono considerate numeriche

spss_trim_values Boolean true Se :spss_use_value_labels=true : ignora gli spazi attorno ai valori e alle etichette dei valori quando vengono convertiti in factor

spss_trim_factor_names Boolean false Elimina gli spazi attorno ai nomi dei livelli

spss_use_missings Boolean true Casi con valori definiti come user-defined missing vengono impoastati a valore mancante

spss_string_as_factor Boolean false Converte le variabili alfanumeriche in factor

R¶

Parametro Tipo Default Descrizione

r_log_width Fixnum 150 Impostazione iniziale del numero colonne del log di R. Nello script usare log_width

total_varname String "._tot" Nome della variabile R del totale casi

fake_weight_varname String "._fake.weight" Nome della variabile R del peso uquale a 1

delete_table_objects Boolean false Elimina precedenti tabelle

Java¶

Parametro Tipo Default Descrizione

java_home String nil Percorso Java SDK (deprecato, usare :jsdk_home_32)

jsdk_home_32 String nil Percorso Java SDK 32 bit

java_heap_xms String "64m" Initial java heap size

java_heap_xmx String "640m" Maximum java heap size

jre_home_32 String nil Percorso Java SE 32 bit

jre_home_64 String nil Percorso Java SE 64 bit

Logo e footer¶

Parametro Tipo Default Descrizione

img String nil Nome o indirizzo file immagine per prima pagina; formati: gif, jpeg, png, jpg

img_link String nil Indirizzo link immagine

img_foot String nil Nome o indirizzo file immagine per footer; formati: gif, jpeg, png, jpg

img_foot_link String nil Indirizzo link immagine per footer

footer String nil Testo footer

HTML¶

Parametro Tipo Default Descrizione

html_print_index Boolean true Stampa indice

html_print_nav Boolean true Stampa pulsanti navigazione

html_print_footer Boolean true Stampa footer

css_html String "ptabs.css" Nome file foglio stile CSS per tavole

css_tl String "ptabs_tl.css" Nome file foglio stile CSS per top-line

theme Fixnum 1 Schema di colori attivo (numero, simbolo o stringa)

PDF¶

Parametro Tipo Default Descrizione

wkhtmltopdf String "{pf32}/wkhtmltopdf/wkhtmltopdf.exe" Percorso eseguibile wkhtmltopdf.exe

pdf_encoding String "iso-8859-15" Character encoding file PDF

css_pdf String "ptabs_pdf.css" Nome file foglio stile PDF

pdf_header String "pdf_header.html" Nome file header

pdf_footer String "pdf_footer.html" Nome file footer

pdf_page_row_number Fixnum 49 Massimo numero di righe per pagina

pdf_zoom Float 0.9 Percentuale ingrandimento/riduzione

Excel¶

Parametro Tipo Default Descrizione

multiple_sheets Boolean false Un foglio per ciascuna tabella

sheet_index_name String "indice" Nome foglio indice

zero_xls Boolean false Carattere che sostituisce lo zero nelle celle (false per lasciare 0)

xls_round Boolean true Valori arrotondati o con tutti i decimali

xls_width_data Float 8.43 Ampiezza delle colonne di dati

xhp1 String nil Altezza (in punti) prima riga pannello

xhp2 String nil Altezza (in punti) seconda riga pannello

xhnote String nil Altezza (in punti) riga note

TXT¶

Parametro Tipo Default Descrizione

txt_page_width Fixnum 178 Ampiezza della pagina in caratteri

txt_page_height Fixnum 64 Ampiezza della pagina in linee

txt_side_size Fixnum 35 Ampiezza della fiancata in caratteri

txt_cell_size Fixnum 8 Ampiezza delle celle in caratteri

txt_net_id String " (NET)" Testo da aggiungere ai net

txt_net_indent Fixnum 2 Numero spazi rientro net

min_split_chars Fixnum 3 Numero minimo di caratteri in cui spezzare le etichette del pannello

hyphen_char String "$" Carattere per inserire un’interruzione nelle etichette del pannello (non inserisce il trattino)

break_char String "|" Carattere per attivare la sillabazione nelle parole delle etichette del pannello (inserisce il trattino)

Matrix¶

Parametro Tipo Default Descrizione

matrix_round Boolean true Valori arrotondati o con tutti i decimali

matrix Boolean true Attiva/disattiva esportazione delle tabelle seguenti

mx Boolean false Attiva/disattiva esportazione della prima tabella seguente

CSV¶

Parametro Tipo Default Descrizione

csv_dec_sep String "," Separatore decimale

csv_col_sep String ";" Separatore campi

DB2ppt¶

Parametro Tipo Default Descrizione

cchart Symbol :colclu Tipo di grafico per statistiche count

schart Symbol :radar Tipo di grafico per statistiche summary

Quartili¶

I valori che definiscono i quartili devono essere specificate con probs_qrt indicando congiuntamente i cinque valori. Impostare a nil i quartili che non si desidera mostrare.

label_qrt modifica in un’unica istruzione le etichette dei quartili.

frm_qrt imposta lo stesso formato per tutti i quartili.

 qrt!
 probs_qrt [0, 0.25, 0.5, 0.75, 1]
 label_qrt ['Q0', 'Q1', 'Q2', 'Q3', 'Q4']
 frm_qrt p:0

E’ possibile calcolare i valore minimo e il valore massimo di una variabile impostando solo due valori:

 probs_qrt [0, nil, nil, nil, 1]
 label_q0 'MIN'
 label_q4 'MAX'

Nota

La modifica dei valori che definiscono i quartili non influisce sul calcolo di mediana (median), scarto interquartile (iqr) e range (range).

Definizione dei formati numerici¶

I formati sono definiti attraverso un hash dove possono essere specificati i seguenti elementi:

:f: formato attivo: :n (numerico), :d (data), :t (tempo), :dt (data/tempo)

:px: prefisso (per esempio: $)

:sx: suffisso (per esempio: %)

:h: carattere di separazione delle migliaia (per nessun separatore usare nil). Se presente, sovrascrive ths_sep

:s carattere di separazione dei decimali (per esempio: ,). Se presente, sovrascrive dec_sep

:p numero di decimali

:d formato data

:t formato tempo

:dt formato data/tempo

Per una statistica possono essere definiti contemporaneamente i formati numerici e quelli di data e tempo. Il parametro :f definisce qual è il formato attivo.

frm_descr imposta contemporaneamente i formati per media, somma, deviazione standard e errore standard della media.

 frm_pct :p => 1, :sx => '%'
 frm_pct p:1, sx:'%'
 frm_count p:0
 frm_mean p:2

 frm_mean t: '%H:%M' # cambia il formato tempo della media
 frm_mean f: :t      # attiva il formato tempo per la media

 frm_descr :f => :d  # attiva il formato data per media, somma,
                     # deviazione standard e errore standard della media

Le sintassi f: :t e :f => :t sono equivalenti. Attenzione, in p: 2 lo spazio è facoltativo (p:2), ma in f: :t è obbligatorio.

Formati tempo: [1]

%Y - anno a 4 cifre

%y - anno a 2 cifre

%m - mese in numero

%B - mese in lettere

%b - mese 3 lettere

%d - giorno del mese

%A - giorno della settimana in lettere

%a - giorno della settimana 3 lettere

%H - ora

%M - minuti

%S - secondi

Temi¶

I colori e le dimensioni dei caratteri dei report HTML, PDF e Excel sono specificati nel file theme.yml. Ulteriori file theme_<nome>.yml (dove nome è il numero o il nome specificato nel parametro di configurazione theme) permettono di modificare anche solo parzialmente i colori. Con l’installazione di pTabs sono inclusi vari temi nella cartella ...\pTabs\lib\pt\resources. theme_1.yml è vuoto e serve semplicemente per richiamare i colori di default, theme_old.yml è il vecchio schema di colori. Sono inoltre disponibili i file theme_sea.yml, theme_sky.yml e theme_pink.yml.

I file dei temi contengono cinque sezioni:

parametri inizianti per tl_: colori top-line in formato HTML
parametri inizianti per rp_: colori report in formato HTML, PDF e XLSX (Excel Open XML Format Spreadsheet)
parametri inizianti per xl_: colori report in formato XLS (Excel 97-2003)
parametri inizianti per h_: dimensioni caratteri formato HTML e PDF
parametri inizianti per x_: dimensioni caratteri formato XLS e XLSX

Per i parametri tl_ e rp_ è possibile indicare il valore esadecimale del colore oppure il nome HTML/CSS. Per i parametri xl_ (Excel 97-2003) è invece disponibile solo un numero limitato di colori.

Per utilizzare un tema, modificare il parametro theme nel file di configurazione, oppure specificare direttamente nello script:

report = ptabs.new do

  theme :sea

theme 1 richiama invece il tema di default.

L’istruzione theme accetta anche un blocco in cui è possibile specificare dei parametri direttamente nello script:

# viene caricato il tema sky variando i valori di alcuni parametri
theme :sky do |t|
  t.h_report_title_sz 30
  t.rp_report_title   "orange"
end

# i valori di alcuni parametri vengono modificati rispetto al tema di default
theme do |t|
  t.h_table_caption_sz  16
  t.x_index_caption_sz  14
  t.rp_table_caption   :purple
end

E’ possibile creare dei propri temi creando dei nuovi file, per esempio theme_cliente.yml, e specificando :cliente o "cliente" nel parametro di configurazione theme oppure theme :cliente direttamente nello script.

I nuovi file possono essere collocati o nella cartella di lavoro o nella cartella dell’utente, per es. c:\stat\user.

ptabs.yml¶

Tutti i parametri hanno dei valori di default specificati nel file ptabs.yml [2].

E’ possibile utilizzare un proprio file ptabs.yml anche con parametri parziali. Più file di configurazione vengono letti in sequenza dalle seguenti posizioni:

dal file eseguibile
dalla cartella che contiene l’eseguibile
dalla cartella user
dalla cartella di sistema dell’utente [3]
dalla cartella di lavoro

Le configurazioni presenti nei file nelle posizioni più basse della lista precedente hanno il sopravvento.

Suggerimento

La cartella user si trova nel percorso di installazione di pTabs. E’ però possibile definire un percorso diverso impostando la variabile d’ambiente PTABS_USER. In tal caso la cartella user non è più attiva e bisogna utilizzare al suo posto quella definita in PTABS_USER.

 # ptabs.yml

 :footer: &copy; 2011 - Company Name
 :img: my_company_logo_big.jpg
 :img_foot: my_company_logo_small.jpg
 :theme: 3
 :dot_to_underscore: false
 :underscore_to_dot: false
 :vars_to_lower_case: false
 :label_rowpct: "% r"
 :label_colpct: "% c"
 :frm_count:
   :p: 0
 :frm_pct:
   :p: 2
   :sx: "%"
 :chisq_formats:
 - :p: 3
 - :p: 0
 - :p: 3
 :pdf_page_row_number: 40

File di risorse¶

I file di risorse di default possono essere estratti da pTabs e copiati nella cartella corrente tramite lo switch rs:

ptabs -rs

Note

[1]	Le variabili di data e tempo devono avere formato numerico ed essere espresse in numero di secondi.

[2]	Il file è in formato YAML.

[3]	La cartella definita dalla variabile d’ambiente `HOME` oppure dalle variabili `HOMEDRIVE` e `HOMEPATH`.