Parametri di configurazione¶

La configurazione di pTabs2 è 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
 stdev_            # 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'

Solo nel file di configurazione¶

Parametro Tipo Default Descrizione

naming_version Integer 28 27 per utilizzare le regole di conversione precedenti alla versione 2.8; 1 per ridurre al minimo le conversioni; 0 per non effettuare conversioni

dot_to_underscore Boolean true Nei nomi delle variabili sostituisce il punto con l’underscore (o con il carattere indicato in varname_chr_sub)

varname_chr_sub String "_" Carettere di sostituzione nei nomi di variabili

varname_to_lowercase Boolean true Converte i nomi di variabili in minuscolo

camel_to_snake_case Boolean false Converte i nomi delle variabili da camelCase a snake_case

warn_varname Boolean true false non visualizza warning per variabili con nomi non validi; true li visualizza sempre; :unsafe non visualizza cambiamenti maiuscolo/minuscolo e punto/underscore

max_warn_varname Integer 50 Numero massimo di warning da mostrare per file; -1 per mostrarli tutti

s_with_only_upper_limit Symbol :warn Comportamento in caso di utilizzo della funzione s con un solo indice: :none, :warn, :error

beep_error Array [500, "A3", "C#4", "F4", "G#4"] Beep sugli errori: false|[time, notes]

beep_warn Boolean false Beep sui warning: false|[time, notes]

beep_end Array [300, "E5"] Beep alla fine dell’esecuzione: false|[time, notes]

clean_labels_file String "cleanlabels.txt" Nome del file con le parole da eliminare nelle etichette

check_version Boolean true Controlla se sono presenti nuove versioni di pTabs2

Configurazione¶

Parametro Tipo Default Descrizione

locale Symbol :it Lingua interfaccia

themename Symbol :ptabs2 Tema di default

script_encoding String "iso-8859-1" Codifica script

csv_encoding String "iso-8859-15" Codifica CSV

spss_encoding String "iso-8859-1" Codifica SPSS

spss_max_string_size Integer 2500 Lunghezza massima stringhe SPSS

spss_write_warnings Boolean false Warning scrittura file spss

html_pretty Boolean false Formatta il codice HTML

direct_call_var Symbol :warn Comportamento in caso di chiamata diretta di una variabile: :none, :warn, :error

rename_not_exist Symbol :error Comportamento quando si cerca di rinominare una variabile che non esiste: :none, :warn, :error

rename_exist Symbol :error Comportamento quando si cerca di rinominare una variabile con il nome di una variabile esistente: :none, :warn, :error

empty_string_as_blank Boolean false In lettura converte le stringhe vuote in valori mancanti

dialog_error Boolean true Attiva o meno la finestra di dialogo con l’errore

long_integer Integer 50 Numero minimo di valori per definire un iteger come long

ptLab¶

Parametro Tipo Default Descrizione

lab_grid_font_family String nil Family font griglie default: Segoe UI

lab_grid_font_weight String nil Weight font griglie default: Normal

lab_grid_font_size String nil Size font griglie default: 90

Report¶

Parametro Tipo Default Descrizione

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

img_encode Boolean false Immagine incorporata nell’HTML

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

img_foot_encode Boolean false Immagine incorporata nell’HTML

footer String nil Testo footer

html_index Boolean true Genera l’indice nell’output HTML

html_index_link Boolean true Genera il link all’indice dopo la tavola nell’output HTML

html_index_nbase Boolean true Mostra il totale casi della tabella nell’indice

render_path String nil Il percorso dei file dei report

item_id Boolean false Aggiunge l’id dell’elemento

item_id_template Array ["{id}", "Table {n}"] Lista di template per l’id dell’elemento: n = progressivo; id = id utente; sys = id sistema

Tabelle¶

Parametro Tipo Default Descrizione

table_compute_mode Symbol :new2 Metodo di calcolo delle tabelle: :new2, :old

stat_by_side_freq Boolean true Statistiche nelle colonne per le tabelle con solo totale (anche by_stat)

value_by_side_freq Boolean false Valori nelle colonne per le tabelle con solo totale (anche by_value)

header_break_word Boolean true E’ possibile spezzare le parole nelle intestazioni di colonna

corner_frame Boolean true Corner con bordo o senza

max_items_show Integer 100 Massimo numero di items

num_of_tails Integer 5 Numero degli item da mostrare in coda

smart_rowlabel Boolean false Evita ripetizioni di etichette

hide_same_text Boolean true Nelle tabelle nasconde la parte iniziale di testo uguale in un set di label

total_after Boolean false

rtotals Symbol :all :one|:all

show_missing_levels Boolean false Visualizzazione categorie missing

all_bold Boolean true Stile bold totale citazioni

all_italic Boolean false Stile italic totale citazioni

na_bold Boolean false Stile bold valori mancanti

na_italic Boolean true Stile italic valori mancanti

rowlabel Boolean false Stampa l’etichetta della variabile di riga

join_row_labels Boolean true Unisce le righe sotto un’unica etichetta quando variabili consecutive hanno la stessa etichetta

data_alt_color Boolean false Attiva il colore alternativo per le celle della tabella

default_corner String nil Etichetta di default del corner

Pannelli¶

Parametro Tipo Default Descrizione

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

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

var_alt_color Boolean false Attiva il colore alternativo per etichette delle variabili di pannello

val_alt_color Boolean false Attiva il colore alternativo per etichette degli item delle variabili di pannello

vjoin_header Boolean true Attiva l’intestazione dei pannelli nelle vjoin

hide_empty_rows Boolean false Elimina i codici senza casi delle variabili categoriali di riga

hide_empty_cols Boolean false Elimina i codici senza casi dalle variabili categoriali di colonna

max_chr_label String nil Numero massimo di caratteri per le etichette delle variabili

max_chr_levels String nil Numero massimo di caratteri per le etichette dei livelli

Etichette¶

Parametro Tipo Default Descrizione

language Array [:it, :en] Lingua etichette

missing_translation Symbol :warn Azione se non viene trovata una traduzione: :none|:warn|:err

title_pos Symbol :caption Posizione titolo tabella: :caption|:banner

repeat_title Boolean false Ripete il titolo nelle tabelle dei pannelli successivi

convert_case Boolean false Converte le etichette di riga e di colonna: :titleize, :capitalize, :upcase, :downcase

show_row_codes Boolean false Mostra codici riga

show_col_codes Boolean false Mostra codici colonna

show_table_descr Boolean false Aggiunge nel titolo il tito di tavola e l’elenco delle variabili

xtab_label_size Integer 50 Numero massimo di carateri nelle etichette di xtab; nil = nessuna limitazione

xtab_clabel_size Integer 25 Numero massimo di carateri nelle etichette di colonna di xtab; nil = nessuna limitazione

stat_descr_pref String nil Prefisso da aggiungere alle statistiche descrittive

stat_descr_suff String nil Suffisso da aggiungere alle statistiche descrittive

clean_labels Boolean true Attiva/disattiva la pulizia delle etichette tramite clean_labels_file

Zero e basse numerosita’¶

Parametro Tipo Default Descrizione

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

no_number String "-"

zero String "-"

drop_zero_if_more_rows Integer 0 Nasconde le righe della tabella con zero casi: 0=non elimina nulla; n=elimina se item>n; -1=elimina sempre

drop_zero_if_more_cols Integer 0 Nasconde le colonne della tabella con zero casi: 0=non elimina nulla; n=elimina se item>n; -1=elimina sempre

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_count Integer 0 Numero di casi per considerare una tabella come tabella con numero basso di casi

low_cell Symbol :print Se la cella/colonna/riga ha un numero basso di casi: print stampa un simbolo (vedi labels), :hide lascia la cella vuota

low_cell_count Integer 0 Numero di casi per considerare una cella come cella con numero basso di casi

low_column_count Integer 0 Numero di casi per considerare una colonna come colonna con numero basso di casi

low_row_count Integer 0 Numero di casi per considerare una riga come riga con numero basso di casi

Statistiche¶

Parametro Tipo Default Descrizione

rtotal Boolean true La riga del totale

ctotal Boolean true La colonna del totale

tcount Boolean true Totale valori assoluti

tcount_u Boolean false Totale valori assoluti non ponderati

tcount_x Boolean false Totale valori assoluti espansi

trowpct Boolean true Totale percentuali riga

tcolpct Boolean false Totale percentuali colonna

count Boolean true Valori assoluti

count_u Boolean false Valori assoluti non ponderati

rowpct Boolean false Percentuali riga

colpct Boolean true Percentuali colonna

totpct Boolean false Percentuali totale

cumpct Boolean false Percentuali colonna cumulate

base Boolean true Base

base_u Boolean false Base non pesata

mean Boolean true Media

mean_inv Boolean false Media inversa

stdev Boolean true Deviazione standard

serr Boolean false Errore standard della media

min Boolean false Minimo

max Boolean false Massimo

limits Boolean false “min-max”

mode Boolean false Moda

median Boolean false Mediana

qtiles Boolean false Quantili

qtile_method Symbol :interpolation Metodo calcolo mediana e quantili con casi pari: :interpolation|:mean|:min|:max

range Boolean false Range, campo di variazione

tsum Boolean false Totale della somma

sum Boolean false Somma

sumpct Boolean false Percentuale della somma

mresp Boolean false Numero medio risposte multiple

nresp Boolean false Numero totale risposte multiple

nvals Boolean false Numero valori

miss Boolean false Risposte mancanti (blank)

miss_u Boolean false Risposte mancanti (blank non pesati)

misspct Boolean false Risposte mancanti percentuali (blank)

misspct_u Boolean false Risposte mancanti percentuali (blank non pesati)

i_conc Boolean false Indice concentrazione

serr_base Symbol :weight Base per il calcolo dello standard error: :raw|:weight|:expansion

Formati¶

Parametro Tipo Default Descrizione

dec_sep String "," Separatore decimali

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

default_format Hash {:type=>:integer, :size=>1, :ndec=>0} Formato di default per le variabili

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

frm_pct Hash {:p=>1} Formato percentuali

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

frm_base Hash {:p=>0} Formato base

frm_mean Hash {:p=>2} Formato media

frm_mean_inv Hash {:p=>2} Formato media inversa

frm_stdev Hash {:p=>2} Formato deviazione standard

frm_serr Hash {:p=>2} Formato errore standard della media

frm_min Hash {:p=>1} Formato minimo

frm_max Hash {:p=>1} Formato massimo

frm_limits Hash {:p=>1} Formato limits

frm_qtiles Hash {:p=>1} Formato quantili

frm_median Hash {:p=>1} Formato mediana

frm_mode Hash {:p=>0} Formato moda

frm_range Hash {:p=>1} Formato range

frm_nvals Hash {:p=>0} Formato numero valori

frm_tsum Hash {:p=>2} Formato totale somma

frm_sum Hash {:p=>2} Formato somma

frm_ic Hash {:p=>2} Formato intervallo confidenza

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

frm_miss Hash {:p=>0} Formato risposte mancanti

frm_miss_u Hash {:p=>0} Formato risposte mancanti

frm_datetime Hash {:t=>"%H:%M:%S", :d=>"%d-%m-%Y", :dt=>"%d-%m-%Y %H:%M:%S"} Formato data e tempo (https://ruby-doc.org/core-2.2.0/Time.html#method-i-strftime)

frm_chi2_val Hash {:p=>3} Formato valore chi2

frm_chi2_df Hash {:p=>0} Formato gradi di liberta’ chi2

frm_chi2_sig Hash {:p=>3} Formato significativita’ chi2

Net¶

Parametro Tipo Default Descrizione

net_pos Symbol :before La posizione dei net: :before, :top, :bottom

net_order Symbol :codes L’ordine dei net nelle singole: :codes, :nets

codes_no_net Symbol :top Posizione dei codici al di fuori dei net quando :net_order=:nets: :top, :bottom, :none

net_computed_pos Symbol :after Posizione dei net calcolati: :before, :after

netonly Boolean false Stampa solo i net

netstyle Boolean true Distingue graficamente i net dagli altri item

net_line_sep Boolean true Separa i net con una linea

save_sng_net Boolean false Salva come variabili i net singoli

Multiple¶

Parametro Tipo Default Descrizione

md_true_value Integer 1 Valore da contare nelle multidicotomy (“citato”)

md_false_value Integer 0 Valore “non citato” nelle multidicotomy

md_label_on_code Boolean false Etichetta item nell’etichette del codice (true) o nell’etichetta della variabile (false)

mc_has_same_labels Boolean true Le variabili di un set di multicategory devono avere le stesse etichette

mc_uniq Boolean true Elimina i valori doppi nelle multicategory

TBox¶

Parametro Tipo Default Descrizione

tbox_label String nil Nel caso di tbox di un solo item :stat stampa l’etichetta della statitica; :var stampa l’etichetta della variabile; nil comportamento deciso da pTabs

tbox_total Boolean true Mostra una riga con la base nelle tabelle tbox

save_tbox_as_md Boolean false Salva le tbox come variabili md

Scale¶

Parametro Tipo Default Descrizione

scale_style Symbol :compact :compact, :long

scale_line_sep Boolean false Separa le variabili con una linea

scale_total Boolean false Mostra una riga con la base nelle tabelle scale

scale_label String nil Nel caso di scale di un solo item :stat stampa l’etichetta della statitica; :var stampa l’etichetta della variabile; nil comportamento deciso da pTabs

base_sumpct Symbol :sum :sum, :count

Basi¶

Parametro Tipo Default Descrizione

base_tcount Symbol :table Metodo di calcolo del totale: :table, :all

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

base_rowpct Symbol :table Metodo di calcolo delle percentuali di riga: :table sui marginali della variabile di fiancata, :var[iable] sui marginali di ciascuna variabile di pannello :all se e’ attivo un filtro, calcola per percentuali sul totale della variabile di fiancata (solo per cat, ord, md e tbox)

base_multi Symbol :cases Metodo di calcolo delle percentuali di colonna nelle tabelle md e mc: :cases, :resp, :all, :var

base_tbox Symbol :table Metodo di calcolo delle percentuali di colonna per le tabelle tbox: :table, :var

Filtri¶

Parametro Tipo Default Descrizione

save_filter Boolean false Salva come variabili i filtri

filter_prefix String "f_" Prefisso variabili filtro

Pesi variabili¶

Parametro Tipo Default Descrizione

wlegend Boolean true Mostra la legenda dei pesi utilizzati

wtemplate String nil Template per mostrare i pesi con le etichette

wlog Boolean false Stampa nel log il risultato dei comandi w e weights

wcomplete Boolean false Aggiunge i pesi dei livelli non spoecificati nei comandi w e weights

Intervalli di confidenza¶

Parametro Tipo Default Descrizione

cim_sig Float 0.05 Livello di significativita’ intervallo di confidenza medie

cim_l Boolean false Intervallo di confidenza medie limite inferiore

cim_s Boolean false Intervallo di confidenza medie limite superiore

cim_e Boolean false Intervallo di confidenza medie errore

cip_sig Float 0.05 Livello di significativita’ intervallo di confidenza proporzioni

cip_l Boolean false Intervallo di confidenza proporzioni limite inferiore

cip_u Boolean false Intervallo di confidenza proporzioni limite superiore

cip_e Boolean false Intervallo di confidenza proporzioni errore

ci_note Boolean true Attiva/disattiva le note

Test¶

Parametro Tipo Default Descrizione

pc_pairs Symbol :var Le colonne da confrontare: :var|:label|:level|:tot|:all|specifiche colonne

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

pc_note_comp Boolean false Nota confronti effettuati

pc_note_comp_text String nil Testo esplicito dei confronti

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

pcm_sig Float 0.05 Livello di significativita’ t-test

pcm_adj Symbol :none Metodo di correzione p-value: :bonf, :none

pcm_minbase Integer 1 Numero minimo di casi per eseguire il test

pcm_note Boolean true Attiva/disattiva le note

pcm_print Boolean false Stampa p-value nel log

pcp Boolean false Attiva/disattiva il Pairwise Comparisons test sulle percentuali

pcp_sig Float 0.05 Livello di significativita’ t-test

pcp_minbase Integer 1 Numero minimo di casi per eseguire il test

pcp_note Boolean true Attiva/disattiva le note

pcp_print Boolean false Stampa p-value nel log

pcp_yates_correction Boolean false Correzione di Yates

pcp_yates_n Integer 100 Numero di casi totali al di sotto dei quali si applica la correzione di Yates

chi2 Boolean false Attiva/disattiva il test del chi quadrato

chi2_val Boolean false Attiva/disattiva il valore del test del chi quadrato

chi2_df Boolean false Attiva/disattiva i gradi di liberta’ per il test del chi quadrato

chi2_sig Boolean true Attiva/disattiva la significativita’ del test del chi quadrato

chi2_sym Boolean false Attiva/disattiva la rappresentazione a simboli della significativita’ del test del chi quadrato

chi2_drop_empty_dim Boolean true Elimina righe o colonne vuote prima del calcolo del chi2

Ponderazione¶

Parametro Tipo Default Descrizione

rake_varname String "ipf" Nome predefinito variabile di ponderazione

rake_maxit Integer 100 Massimo numero di iterazioni

rake_delta Float 0.01 Scarto massimo ideale/risultato

rake_stop_on_failure Boolean true Comportamento in caso di non convergenza: errore (true), continua con un warning ma genera comunque le variabili di ponderazione (false)

missing_weights Symbol :error Comportamento in caso di valori nulli nella variabile di ponderazione: :none, :warn, :error

XLSX¶

Parametro Tipo Default Descrizione

xls_percent Symbol :pct100 Formato percentuali: numero senza simboli (:number), formato percentuale base 100 (:pct100), formato percentuale base 0 (:pct0)

xls_round Boolean true Valori percentuali arrotondati o con tutti i decimali

xls_round_count Boolean true Valori assoluti arrotondati o con tutti i decimali

xls_zero String "-" Formato per zero

xhp0 String nil Altezza (in punti) riga titoli del pannello

xhp1 String nil Altezza (in punti) riga variabili del pannello

xhp2 String nil Altezza (in punti) riga livelli del pannello

xhnote String nil Altezza (in punti) riga note

xlsx_index Boolean true Genera l’indice

xlsx_index_link Boolean true Genera il link all’indice dopo la tavola nell’output xlsx

xlsx_index_nbase Boolean false Mostra il totale casi della tabella nell’indice

xlsx_link_title Boolean true Mette il link sui titoli nel caso di un solo foglio

xlsx_link_names String nil Vettore con le etichette dei link

xlsx_header String nil Header file xlsx

xlsx_footer String nil Footer file xlsx

xlsx_tags Boolean false Attiva i metatadi

xlsx_tags_id Boolean true Metadati: id

xlsx_tags_panel Boolean true Metadati: pannello

xlsx_tags_sheets Symbol :all I fogli in cui inserire i metadati: :all (default)|#]

xlsx2_sheet1_name String "%" Nome foglio 1

xlsx2_sheet2_name String "VA" Nome foglio 2

xlsx2_sheet1_stats Array [:stable, :img, :tcount, :tcount_u, :tcount_x, :trowpct, :tcolpct, :rowpct, :colpct, :cumpct, :tot... Statistiche foglio 1

xlsx2_sheet2_stats Array [:stable, :img, :tcount, :tcount_u, :tcount_x, :trowpct, :tcolpct, :count, :count_u, :miss, :miss_... Statistiche foglio 2

xlsx2s_sheet1_name String "VA %" Nome foglio 1

xlsx2s_sheet2_name String "%" Nome foglio 2

xlsx2s_sheet1_stats Array [:all] Statistiche foglio 1

xlsx2s_sheet2_stats Array [:stable, :img, :tcount, :tcount_u, :tcount_x, :trowpct, :tcolpct, :rowpct, :colpct, :cumpct, :tot... Statistiche foglio 2

xlsx3_sheet1_name String "VA %" Nome foglio 1

xlsx3_sheet2_name String "%" Nome foglio 2

xlsx3_sheet3_name String "VA" Nome foglio 3

xlsx3_sheet1_stats Array [:all] Statistiche foglio 1

xlsx3_sheet2_stats Array [:stable, :img, :tcount, :tcount_u, :tcount_x, :trowpct, :tcolpct, :rowpct, :colpct, :cumpct, :tot... Statistiche foglio 2

xlsx3_sheet3_stats Array [:stable, :img, :tcount, :tcount_u, :tcount_x, :trowpct, :tcolpct, :count, :count_u, :miss, :miss_... Statistiche foglio 3

xlsx3s_sheet1_name String "STAT" Nome foglio 1

xlsx3s_sheet2_name String "%" Nome foglio 2

xlsx3s_sheet3_name String "VA" Nome foglio 3

xlsx3s_sheet1_stats Array [:stable, :img, :tcount, :tcount_u, :tcount_x, :trowpct, :tcolpct, :rowpct, :colpct, :cumpct, :tot... Statistiche foglio 1

xlsx3s_sheet2_stats Array [:stable, :img, :tcount, :tcount_u, :tcount_x, :trowpct, :tcolpct, :rowpct, :colpct, :cumpct, :tot... Statistiche foglio 2

xlsx3s_sheet3_stats Array [:stable, :img, :tcount, :tcount_u, :tcount_x, :trowpct, :tcolpct, :count, :count_u, :miss, :miss_... Statistiche foglio 3

X2¶

Parametro Tipo Default Descrizione

x2_percent Symbol :pct100 Formato percentuali: numero senza simboli (:number), formato percentuale base 100 (:pct100), formato percentuale base 0 (:pct0)

x2_round Boolean true Valori arrotondati o con tutti i decimali

x2_zero String "-" Formato per zero

x2_sections Symbol :sheet Sezioni in fogli differenti (:sheet) o in un unico foglio (:join)

x2_stats_total Symbol :tcount Statistiche per la base totale

x2_stats_rtotal Symbol :tcount Statistiche per la riga della base

x2_stats_count_total Symbol :count Statistiche di distribuzione di frequenze per la colonna del totale

x2_stats_count Symbol :count Statistiche di distribuzione di frequenze per le colonne dei break

x2_stats_summ_total Symbol :mean Statistiche riassuntive per la colonna del totale

x2_stats_summ Symbol :mean Statistiche riassuntive per le colonne dei break

PDF¶

Parametro Tipo Default Descrizione

wkhtmltopdf String "C:/Program Files/wkhtmltopdf/bin/wkhtmltopdf.exe" Percorso e nome dell’eseguibile wkhtmltopdf

pdf_encoding String "UTF-8" Encoding pagina

pdf_zoom Float 0.9 Zoom pagina

pdf_page_size String "A4" Formato pagina: A4/A3/Letter/Legal...

pdf_landscape Boolean true Orientamento pagina: Landscape (true), Portrait (false)

pdf_gray Boolean false Scala di grigi (true), colori (false)

pdf_footer_positions Array [:img, :footer, :pages] Ordine degli elementi del footer: :img, :footer, :page|:pages

pdf_margins Array ["1cm", "1cm", "1.5cm", "1cm"] Margini: top, right, bottom, left

pdf_section_page Boolean true Titolo della sezione in una pagina separata

pdf_panel_new_page Boolean false Pannelli in pagine diverse (true) o nella stessa pagina (false)

Triple-S¶

Parametro Tipo Default Descrizione

sss_xml_version Float 3.0 Versione Triple-S XML nella generazione dei file

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 Integer 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 Integer 0 Numero minimo di casi nella cella

mhl_minus Boolean true Calcola accentuazioni medie anche su scostamenti negativi

Autotab¶

Parametro Tipo Default Descrizione

group_delimiter String "_." Separatori nome-progressivo

autotab_max_items Integer 30 Massimo numero di items

autotab_by_val Symbol :sets Tavole orizzontali per: :none, :sets, :all

autotab_scale_summary Boolean false Per le batterie di ord produce anche una tabella riassuntiva di scale true|false

autotab_sng_cat Boolean false Non tabula mai le singole come ordinali true|false

autotab_stat_scale Array [:base, :mean, :stdev, :sum, :min, :max, :median, :mode, :range, :nvals, :miss] Default statistiche per scale

autotab_stat_ord Array [:tcount, :trowpct, :count, :colpct, :base, :mean, :stdev, :miss] Default statistiche per ord

autotab_stat_cat Array [:tcount, :trowpct, :count, :colpct, :miss] Default statistiche per cat

autotab_stat_md Array [:tcount, :trowpct, :count, :colpct, :nresp, :mresp, :miss] Default statistiche per md

autotab_stat_mc Array [:tcount, :trowpct, :count, :colpct, :nresp, :mresp, :miss] Default statistiche per mc

autotab_stat_alpha Array [:tcount, :trowpct, :count, :colpct, :nvals, :min, :max, :mode, :miss] Default statistiche per alpha

autotab_layout Symbol :banner Layout del report: :normal|:banner|:compact|:table|nil

PowerPoint¶

Parametro Tipo Default Descrizione

pptx_server_name String "PowerPoint.Application" Nome del server PowerPoint

pptx_chart_template String "charts_template" Template (potx) per presentazione grafici

Charts¶

Parametro Tipo Default Descrizione

R¶

Parametro Tipo Default Descrizione

r_path String nil Percorso R

r_platform String nil Piattaforma R (:i386|:x64) se specificato anche :r_path

r_library_add_folders String nil Cartelle aggiuntive librerie

r_print Boolean false Stampa le istruzioni R

r_render Symbol :both Dove devono essere indirizzati gli output di R: :log|:report|:both

r_plot_w Integer 800 Ampiezza grafico in px

r_plot_h Integer 600 Altezza grafico in px

r_theme1 Symbol :gray Tema 1 grafici ggplot

r_theme2 Symbol :light Tema 2 grafici ggplot

r_theme3 Symbol :classic Tema 3 grafici ggplot

r_palette String "Accent" Palette di default

r_guess_max String nil Permette di impostare il parametro guess_max per read_csv() (default: min(1000, n_max))

DB¶

Parametro Tipo Default Descrizione

ace_provider String "Microsoft.ACE.OLEDB.16.0" Provider ACE

params?¶

params? stampa nell’output l’elenco dei parametri con i relativi valori e la descrizione.

Suggerimento

Per la configurazione delle etichette vedi il paragrafo Etichette standard in Internazionalizzazione.

Formati date e tempo¶

Oltre al parametro frm_datetime che imposta i formati di tempo, data e data+tempo, sono disponibili i metodi frm_t, frm_d e frm_dt per impostare i formati singolarmente.

frm_t accetta inoltre il flag %D per il numero di giorni. Se non presente, i secondi eccedenti le ventiquattro ore verranno conteggiati inle ore

 frm_datetime :t=>"%H:%M:%S", :d=>"%d/%m/%Y", :dt=>"%d/%m/%Y %H:%M:%S"

 frm_d "%d %b %Y"

Layout¶

layout permette di impostare velocemente lo stile di visualizzione del report. Agisce modificando congiuntamente alcuni parametri di configurazione.

Argomenti:

:normal: visualizzazione normale
:banner: visualizzazione con il titolo della tavola inserito nella tabella
:compact: visualizzazione con il titolo della tavola inserito nella tabella, senza i link all’indice e senza piè di pagina
:table: come :compact, ma senza l’indice

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)

: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
 frm_pct p:1
 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.

Temi¶

I colori e le dimensioni dei caratteri dei report HTML, PDF e Excel sono specificati nel file theme_base.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 ...\pTabs2\lib\resources (sea, sea2, sky, pink e b&w).

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

1	theme :sea

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\user2.

Inoltre è possibile modificare i colori direttamente nello script:

color_report_title '#AA00FF'
color_table_alt_bg '#FFFFD4'

config.pth¶

Nella cartella pTabs-user è possibile creare un file di testo nominato config.pth con un percorso per ciascuna riga. Tali percorsi verranno aggiunti ai percorsi di ricerca dei file di configurazione e di risorse.

config.pth può essere utile per definire percorsi di rete in cui inserire file di configurazione e di risorse comuni a un gruppo di lavoro. Per non provocare rallentamenti nell’esecuzione di pTabs, assicurarsi che gli eventuali percorsi di rete inseriti siano velocemente accessibili.

ptabs2.yml¶

Tutti i parametri hanno dei valori di default specificati nel file ptabs2.yml [1].

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

dalla cartella di installazione di pTabs2
dalle cartelle indicate in config.pth
dalla cartella pTabs-user
dalle cartelle genitori della cartella di lavoro
dalla cartella di lavoro

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

I parametri della sezione Solo nel file di configurazione, per avere efficacia, devono essere impostati in un file di configurazione [2]:

ptabs2.yml:

---
:camel_to_snake_case: false

ptabs_init.pt2¶

All’avvio, pTabs2 carica tutti i file ptabs_init.pt2 che trova nei seguenti percorsi e in questo ordine:

dalla cartella di installazione di pTabs2
dalle cartelle indicate in config.pth
dalla cartella pTabs-user
dalle cartelle genitori della cartella di lavoro
dalla cartella di lavoro

Il file può contenere qualsiasi istruzione valida pTabs2 che verrà eseguita prima di qualsiasi istruzione presente dello script. Il percorso di lavoro è lo stesso dello script anche se il file ptabs_init.pt2 si trova altrove.

Tutti i file ptabs_init.pt2 trovati vengono eseguiti, quindi è necessario considerare l’eventuale sovrapporsi delle istruzioni contenute nei diversi file.

Il file può essere utile, per esempio, per:

inserire le proprie configurazioni invece di utilizzare un file ptabs2.yml personale

inserire le configurazioni comuni di un progetto

definire dati e funzioni di uso comune

Note

[1]	Il file è in formato YAML.

[2]	Alcuni di questi parametri possono essere modificati all’interno dello script con la sintassi `Setting.nome_parametri`: Setting.camel_to_snake_case = true