R/global.R

Defines functions resetOptions settoken getglobalPM25Options setbaseurl setworldcities

Documented in getglobalPM25Options resetOptions setbaseurl settoken setworldcities

##
## Global variable for package
##

globalPM25.options <- list(token = "demo",
                           baseURL = "http://api.waqi.info",
                           apl_description = c("Good", "Moderate", "Unhealthy for sensitive groups", "Unhealthy", "Very Unhealthy", "Hazardous"),
                           apl_color = c("green", "yellow", "#FB6401", "red", "#84428D", "#7E0101"),
                           worldcities = c('mumbai', 'tokyo', 'seoul', 'delhi', 'jakarta', 'paris', 'moscow', 'mexico city', 'san jose',
                                            'Shanghai', 'beijing', 'hongkong', 'istanbul', 'london', 'taipei', 'bangkok', 'chicago', 'newyork',
                                            'manila', 'buenos aires', 'seattle', 'dubai', 'sydney', 'melbourne',
                                            'singapore', 'madrid', 'chennai', 'kolkata', 'osaka', 'bangalore',
                                            'kuala lumpur', 'milan', 'berlin', 'Tel Aviv', 'lisbon', 'Vancouver', 'toronto', 'Munich',
                                            'Copenhagen'),
                           worlduids = c('7020','5573','5508','7024','8647','5722','3330','1437','1451','3308','4143',
                                         '5724','1597','5773','7397','3308','4143','5724','1597','5773','7397','3309','8259','8397',
                                         '5855','3250','3246','1663','5725','8191','7023','7021','5543','8191','5780','9118',
                                         '6132','5783','8379','4230','5914','6037','3317'))

#' Reset the global package variable \code{globalPM25.options}
#'
#' @return the default options
#' @importFrom utils assignInMyNamespace
#' @export
#' @examples
#' \dontrun{
#'   resetOptions()
#' }
#'
resetOptions <- function() {
    assignInMyNamespace("globalPM25.options", list(token = "demo",
                                                   baseURL = "http://api.waqi.info",
                                                   apl_description = c("Good", "Moderate", "Unhealthy for sensitive groups", "Unhealthy", "Very Unhealthy", "Hazardous"),
                                                   apl_color = c("green", "yellow", "FB6401", "red", "84428D", "7E0101"),
                                                   worldcities = c('mumbai', 'tokyo', 'seoul', 'delhi', 'jakarta', 'paris', 'moscow', 'mexico city', 'san jose',
                                                                    'Shanghai', 'beijing', 'hongkong', 'istanbul', 'london', 'taipei', 'bangkok', 'chicago', 'newyork',
                                                                    'manila', 'buenos aires', 'seattle', 'dubai', 'sydney', 'melbourne',
                                                                    'singapore', 'madrid', 'chennai', 'kolkata', 'osaka', 'bangalore',
                                                                    'kuala lumpur', 'milan', 'berlin', 'Tel Aviv', 'lisbon', 'Vancouver', 'toronto', 'Munich',
                                                                    'Copenhagen')))

    globalPM25.options
}

#' Set the token
#'
#' @description request your peronal token from \url{http://aqicn.org/data-platform/token/#/}
#' @param token the value to assign
#' @return the changed options
#' @importFrom utils assignInMyNamespace
#' @export
#' @examples
#' \dontrun{
#'   settoken("demo")
#' }
#'
settoken <- function(token) {
    globalPM25.options <- getglobalPM25Options()
    globalPM25.options$token <- token
    assignInMyNamespace("globalPM25.options", globalPM25.options)
    globalPM25.options
}


#' Return package options
#'
#' @return package options
#' @export
#' @examples
#' \dontrun{
#'   getglobalPM25Options()
#' }
#'
getglobalPM25Options <- function() {
   globalPM25.options
}


#' Set the root url
#'
#' @param baseurl the value to assign
#' @return the changed options
#' @importFrom utils assignInMyNamespace
#' @examples
#' \dontrun{
#'   setbaseurl("http://api.waqi.info")
#' }
#' @keywords internal
#'
setbaseurl <- function(baseurl) {
  globalPM25.options <- getglobalPM25Options()
  globalPM25.options$baseurl <- baseurl
  assignInMyNamespace("globalPM25.options", globalPM25.options)
  globalPM25.options
}

#' Set the city names to be queryed
#'
#' @param citynames character vector of city names
#' @return the changed options
#' @importFrom utils assignInMyNamespace
#' @examples
#' \dontrun{
#'   setworldcities(c("tokyo", "beijing"))
#' }

setworldcities <- function(citynames) {
  globalPM25.options <- getglobalPM25Options()
  globalPM25.options$worldcities <- citynames
  assignInMyNamespace("globalPM25.options", globalPM25.options)
  globalPM25.options
}
jinhuali/globalPM25 documentation built on May 19, 2019, 7:16 a.m.