label package:unknown R Documentation Consulta dados on line e geracao de arquivos de exibicao grafica de textos em formato PDF. O layout do arquivo gerado e um modelo generico do aplicado em etiquetas de colecoes como as presentes em herbarios. Description: A partir de dataframe fornecido, a funcao possui a opcao de realizar uma consulta ao banco de dados on line do Flora do Brasil 2020 (http://floradobrasil.jbrj.gov.br/) e gera um arquivo PDF contendo as informacoes do data frame, conferidas ou não com o banco on line. O arquivo e gerado em um layout generico de etiqueta de herbario utilizado na confeccao de exsicatas. Ha opcoes de formatacao do tamanho e orientacao do arquivo para impressao, tamanho de cada etiqueta, tamanho das margens e conteudo do titulo e subtitulo. Usage: label (data, sep, consult, paper, size.lab, margin.in, margin.out, tit, subtit, sep.col, ... ) Arguments: data: caracter com o nome do arquivo dos dados ou do objeto que contem os dados. Os dados devem ser uma planilha com titulo das colunas na primeira linha. As colunas se referem as informacoes que devem constar nas etiquetas sobre cada material. Os materiais sao as exsicatas, expressas nas linhas. Para cada linha sera gerada um arquivo de etiquetas. O titulo das colunas devem ser, nao necessariamente nessa ordem: herbarium_code, family, genus, epithet, author, determiner, determined, country, state, city, locality, note, datum, zone, UTMx, UTMy, altitude, date, observation, main_collector, collector_number, other_collectors. As informacoes que se referem cada coluna: herbarium_code, codigo do herbario que identifica cada material (exsicata); family, nivel taxonomico de familia; genus, nivel taxonomico de genero; epithet, epiteto especifico; author, autor da especie; determiner, quem identificou a especie do material; determined, data em que ocorreu a determinacao; country, pais onde coletou o material; state, estado onde coletou o material; city, municipio onde coletou o material; locality, alguma descricao da localidade onde coletou o material; note, alguma observacao sobre o local de coleta; datum, datum; zone, zona geografica; UTMx; UTMy; altitude, altitude do local de coleta em metros; date, data da coleta; observation, descricao do material; main_collector, principal coletor; collector_number, numero que o coletor atribui ao material; other_collectors, demais pessoas que acompanharam a coleta. sep: caracter utilizado como separador entre dados de colunas diferentes na planilha de dados que deve ser informado pelo usuario. consult: teste lógico (informar TRUE ou FALSE). Se TRUE a funcao consulta as informacoes das colunas denominadas "genus" e "epithet" no banco de dados on line Flora do Brasil 2020 (http://floradobrasil.jbrj.gov.br/). Se FALSE a funcao não executa a consulta e gera a etiqueta da forma como os dados foram informados em data. Default: "TRUE". paper: caracter que define o tamanho do arquivo desejado. Por exemplo: "a4", "letter", ... Default: "a4r". size.lab: vetor numerico que determina tamanho da etiqueta em polegadas. As ordem das posicoes no vetor referem-se as seguintes dimensoes da etiqueta c(width, height). Default: c(5,3). margin.in: vetor numerico que determina a distancia em numero de linhas entre o conteudo de cada etiqueta e a borda da etiqueta. A ordem das posicoes no vetor corresponde as distancias nas seguintes regioes da etiqueta: c(bottom, left, top, right). Default: c(0.5,0.5,0.5,0.5). margin.out: vetor numerico que determina a distancia em numero de linhas entre a borda do dispositivo grafico, esse que correspondera a borda do papel, e a borda da etiqueta. A ordem das posicoes no vetor corresponde as distancias nas seguintes regioes da etiqueta: c(bottom, left, top, right). Default: c(0.5,0.5,0.5,0.5). tit: caracter informado pelo usuario que define o titulo localizado na primeira linha da etiqueta, normalmente o nome do herbario. subtit: caracter informado pelo usuario que define o subtitulo localizado na segunda linha da etiqueta, normalmente a sigla do herbario e o numero de referencia dado ao material a ser etiquetado. sep.col: caracter informado pelo usuario que define os separadores entre as informacoes expressas por cada coluna em cada linha (material) ao concatenar na formacao do texto da etiqueta. Recomenda-se adicionar o um caracter de espaço (" ") e algum outra caracter como separador. Details: Para a execucao da funcao e necessario ter instalado e carregado o pacote "flora". A consulta aos dados on line pelo argumento "consult = TRUE" é realizada pela execucao da funcao "get.taxa" do pacote "flora" de autoria de Carvalho, G. (2017). Para a execucao da consulta é preciso ter conexao com a Internet. A consulta realiza a verificacao da escrita dos nomes cientificos dos dados presentes nas colunas "genus" e"epithet", além de obter o dado da coluna "author" e corrigir para o nome mais atual da espécie quando for necessário. Para verificar as opcoes dos tipos de papel e orientacoes ver opcoes do argumento "paper" da funcao pdf{grDevices}. Nos valores default para paper, margin.in, margin.out e size.lab, recomenda-se o uso maximo de 68 caracteres para os dados presentes nas colunas "observation" e para as colunas "main_collector", "collector_number" e "other_collectors" contabilizados juntos. Recomenda-se, tambem, uso maximo de 136 caracteres para as colunas "country", "state", "city", "locality", "note", "datum", "zone", "UTMx", "UTMy", "altitude" e "date" contabilizados juntos. Value: A funcao retorna um arquivo pdf contendo 4 etiquetas para cada material (linha) da planilha de dados no diretorio a que o R esta vinculado. Warning: A funcao retorna um aviso quando algum dado das colunas "genus" e "epithet" não foram encontrados na consulta realizada ao Flora do Brasil 2020, apontando alguma razao para isso que e o fato do dado não existir no banco de dados on line por se tratar de uma especie exotica. Author(s): Maria Gabriela Kiss Cornia maria.cornia@usp.br References: Carvalho, G. 2017. Package "flora". Disponível em: . Acesso em: 20 jun 2017. See Also: Pacote: "taxize". Funcoes: plot(), pdf(), text(), mtext(), paste(). Examples: #Exemplo 1 #Criando vetores para compor um exemplo de dataframe de 3 linhas que correspondem a 3 materiais para os quais deseja-se produzir etiquetas. herbarium_code <- c("123", "456", "789") family <- c("Myrtaceae", "Lauraceae", "Melastomataceae") genus <- c("Myrceugenia", "Ocotea", "Miconia") epithet <- c("miersiana", "pulchella", "cinerascens") author <- c("(Gardner)Legrand et Kausel", "(Nees et Mart.) Mez", "Miq.") determiner <- c("Fulano", "Ciclano", "Beltrano") determined <- c("01_02_03", 04_05_06", "07_08_09") country <- c("Brasil","Brasil","Brasil") state <- c("SP", "MG", "RJ") city <- c("São Paulo", "Belo Horizonte", "Rio de Janeiro") locality <- c("aaaaaaa","bbbbbbb","ccccccc") note <- c("ddddddddd", "fffffffff", "ggggggg") datum <- c("WGS84", "WGS84","WGS84") zone <- c("23K", "23K", "23K") UTMx <- c("1111111", "22222222", "33333333") UTMy <- c("4444444", "5555555", "66666666") altitude <- c("777","888","999") date <- c("01_02_03", 04_05_06", "07_08_09") observation <- c("xxxxxxxxxxxxxxxxxxxxxxxx", "yyyyyyyyyyyyyyy", "zzzzzzzzzzzzzz") main_collector <- c("Fulano","Fulano","Fulano") collector_number <- c("100","101","102") other_collectors <- c("Ciclano, Beltrano", "Ciclano, Beltrano", "Ciclano, Beltrano") #criando o dataframe de exemplo dados <- data.frame(herbarium_code, family, genus, epithet, author, determiner, determined, country, state, city, locality, note, datum, zone, UTMx, UTMy, altitude, date, observation, main_collector, collector_number, other_collectors) #executando a funcao label(dados, sep="\t", tit="HERBÁRIO X", subtit="SIGLA ", sep.col= "; ") #Exemplo 2 #lendo planilha de dados como dataframe e salvando como objeto no R dados <- read.table("dados.txt", sep="\t", header=TRUE) #executando a funcao label(dados, sep="\t", consult=TRUE, paper="a4r", size.lab = c(5,3), margin.in = c(0.5,0.5,0.5,0.5), margin.out = c(0.5,0.5,0.5,0.5), tit="HERBÁRIO X", subtit="SIGLA ", sep.col= "; ")