Filter data sets

Description

Filter data set by column(s). Takes as input a data.frame (not only ISTAT ones) and allows you to select for which column(s) value(s) to filter the dataset. Alternatively, use filter_istat_interactive for an interactive version.

Usage

filter_istat(dataset, columns, datatype, lang = "ita")

Arguments

Value

It returns the filtered data set.

Examples

filter_istat(iris, columns = "Species", datatype = "setosa") #Here,
#the function filters the data set 'iris' for the value 'setosa' of the column 'Species'.
filter_istat(iris, columns = c("Species","Petal.Width"),
datatype = list(c("virginica","setosa"), c("0.1","1.9")))
# Here, the function filters the data set 'iris' for the values 'virginica'
#and 'setosa' of the column 'Species' and for the values '0.1' and '1.9' of
#the column 'Petal.Width'.

Filter data set interactively

Description

An interactive and more intuitive version of filter_istat function. It filters data set by column(s). Takes as input a data.frame (not only ISTAT ones) and allows you to select for which column(s) value(s) to filter the data set interactively.

Usage

filter_istat_interactive(dataset, lang = "ita")

Arguments

Value

It returns the filtered data set.

Note

In this first version, language parameter works only with data sets downloaded with get_i_stat (provider I.Stat).

Examples

filter_istat_interactive(iris)

Download data sets by id (source: I.Stat)

Description

Download data sets from I.Stat (old ISTAT provider). Alternatively, use get_istatdata to download data sets from IstatData (new ISTAT provider). Note that in this first version of the package, only get_i_stat allows you to download variable labels, while get_istatdata has not this functionality yet. The parameters "id_dataset" to download data sets can be found using list_i_stat function or search_i_stat function.

Usage

get_i_stat(id_dataset,
           start_period=NULL,
           end_period=NULL,
           recent=FALSE,
           csv=FALSE,
           xlsx=FALSE,
           lang="both")

Arguments

Value

It returns the data set as data.frame. It can be saved to environment or as .csv/.xlsx.

Note

Downloading may take some time. Future versions will speed up the process.

Examples

get_i_stat("12_60")
get_i_stat("12_60", start_period=2015, end_period=2018)
get_i_stat("12_60", start_period=2015, end_period=2015)
get_i_stat("12_60", recent=TRUE, lang="eng")

Download data set by agencyId, id and version (source: IstatData)

Description

Download data sets from IstatData (new ISTAT provider). Alternatively, use get_i_stat to download data sets from I.Stat (old ISTAT provider). Note that in this first version of the package, only get_i_stat allows you to download variable labels, while get_istatdata has not this functionality yet. The parameters "agencyId","dataset_id" and "version" to download the data sets can be found using list_istatdata function or search_istatdata function.

Usage

get_istatdata(agencyId,
             dataset_id,
             version,
             start=NULL,
             end=NULL,
             recent=FALSE,
             csv=FALSE,
             xlsx=FALSE)

Arguments

Value

It returns data set as data.frame. It can be saved to environment or as .csv/.xlsx.

Note

Downloading may take some time. Future versions will speed up the process.

Examples

get_istatdata("IT1", "12_60_DF_DCCV_CONSACQUA_2" , "1.0",recent = TRUE)
get_istatdata("IT1", "12_60_DF_DCCV_CONSACQUA_2" , "1.0", start = 2015, end = 2018)

Obtain the complete list of available data sets (source: I.Stat)

Description

Obtain the complete list of available data sets (source: I.Stat)

Usage

list_i_stat(lang = "ita")

Arguments

Value

It returns the complete list of available data sets from I.Stat with their id and name.

Examples

list_i_stat()

Obtain the complete list of available data sets (source: IstatData)

Description

Obtain the complete list of available data sets (source: IstatData)

Usage

list_istatdata(lang = "ita")

Arguments

Value

It returns the complete list of available data sets from IstatData with their agencyId, id, version and name.

Examples

list_istatdata()

Plot dataset interactively

Description

Build different types of exploratory graphs (scatter plot, bar plot, pie chart). You can interactively choose the plot that you want create. Once you have chosen the plot, you can interactively choose the variables from the data set for which you want to build the plot.

Usage

plot_interactive(df)

Arguments

Value

It returns the chosen plot.

Note

plot_interactive allows you to have an idea about the general trend of your data, and it's intended to be used with exploratory purpose.

Examples

if(interactive()) {
  plot_interactive(iris)
}

Search data sets by keywords (source: I.Stat)

Description

Search I.Stat data sets by keywords. To download data sets, use "get_i_stat" function and insert data set id.

Usage

search_i_stat(keywords,
              lang = "ita")

Arguments

Value

It returns a list of data sets containing the keyword(s) with their id and name.

Note

Searching may take some time. Future versions will speed up the process.

Examples

search_i_stat(c( "incidenti", "stradali"))
search_i_stat("population", lang="eng")

Search data sets by keywords (source: IstatData).

Description

Search IstatData data sets by keywords. To download data sets use "get_istatdata" function and insert agencyId, id, version.

Usage

search_istatdata(keywords,
                 lang = "ita")

Arguments

Value

It returns a list of data sets containing the keyword(s) with their agencyId, id, version and name.

Note

Searching may take some time. Future versions will speed up the process.

Examples

search_istatdata(c( "incidenti", "stradali"))
search_istatdata("population", lang="eng")

shinyIstat

Description

A graphic interface that makes searching, downloading and filtering data sets from Istat easier. Call shinyIstat() to get started. This shinyApp was built using the same functions of istat package but they have been adapted for the shiny. You will find additional information and help inside the app.

Usage

shinyIstat()

Value

It opens the app.

Note

Calling a ShinyApp equals to calling a R function. For this reason, once called shinyIstat(), R will be busy processing it until the app will be closed. As a consequence, all other R functionalities can be processed only when the app is closed.

Examples

if(interactive()) {
  shinyIstat()
}