Package 'gerefer'

Title: Preparer of Main Scientific References for Automatic Insertion in Academic Papers
Description: Generates a file, containing the main scientific references, prepared to be automatically inserted into an academic paper. The articles present in the list are chosen from the main references generated, by function principal_lister(), of the package 'bibliorefer'. The generated file contains the list of metadata of the principal references in 'BibTex' format. Massimo Aria, Corrado Cuccurullo. (2017) <doi:10.1016/j.joi.2017.08.007>. Caibo Zhou, Wenyan Song. (2021) <doi:10.1016/j.jclepro.2021.126943>. Hamid Derviş. (2019) <doi:10.5530/jscires.8.3.32>.
Authors: Márcio Eustáquio [cre], Márcio Eustáquio [aut]
Maintainer: Márcio Eustáquio <[email protected]>
License: GPL-3
Version: 0.1.1
Built: 2024-12-25 07:05:51 UTC
Source: CRAN

Help Index


Preparer of main references for automatic insertion in scientific articles

Description

The article_bib function prepares the metadata of the main scientific references to be automatically included in a scientific article. Initially, the user obtains the list of main references using the principal_lister function from the bibliorefer package. Then, read the articles, choose the ones you prefer, and display the positions of these articles in the input parameter, position_artic, of the article_bib function. The article_bib function internally calls the gerard_lister and bibtex_lister functions. The gerard_lister function separates and organizes the metadata, of each of the articles in the list chosen by the user, and stores them in a dataframe. Then, the bibtex_lister function is applied to the set of metadata organized in the dataframe and converts it to the BibTex style. The output of the article_bib function is the file with the .bib extension, containing the list of references in BibTex format, prepared to be automatically included in the reference list of a scientific paper.

Usage

article_bib(input_date, input_tam, position_artic, total_list)

Arguments

input_date

is a dataframe with the scientific production database obtained of colection WoS, Scopus and others

input_tam

is the length of the dataframe with the main scientifics articles, obtained using package bibliorefer.

position_artic

is a parameter that shows the positions of the articles in the main list, obtained using package bibliorefer, chosen to be included in the reference list of a scientific paper. If part of the list is used, the set of articles is presented through a sequence or a concatenated set. If the complete list is used, the complete sequence is created

total_list

is the parameter that defines whether all articles from the main list, obtained using package bibliorefer, will be used or not. This parameter contains the logical values TRUE or FALSE. If the full list is used, the value is TRUE. Otherwise, if a part of the list is used, the value is FALSE

Value

This function returns a file with the .bib extension, containing the list of references in bibtex format, prepared to be automatically included in the reference list of a scientific paper.

References

1 - Aria, M. & Cuccurullo, C. (2017) bibliometrix: An R-tool for comprehensive science mapping analysis, Journal of Informetrics, 11(4), pp 959-975, Elsevier. 2 - Bibliometric indicators to evaluate scientific activity. C García-Villar, J M García-Santos. Radiologia (Engl Ed). 2021 May-Jun;63(3):228-235.

Examples

# Example 1 - Concatenated position article

# File of database
file_db <- system.file("extdata","example_database.csv", package = "gerefer")
separator <- ","

# Parameters of the function
input_date <- example_database(file_db, separator)
input_tam <- 50
total_list <- FALSE
position_artic <- c(1, 2, 3, 5, 6, 8, 10, 12, 15, 17, 19, 23, 24,
     26, 28, 29, 30, 32, 33, 35, 36, 37, 38, 39, 40, 42, 44, 46, 47, 48)

#Calls the function article_bib
lister_bibtex <- article_bib(input_date, input_tam, position_artic, total_list)
lister_bibtex

# Example 2 - Position article in sequence

# File of database
file_db <- system.file("extdata","example_database.csv", package = "gerefer")
separator <- ","

# Parameters of the function
input_date <- example_database(file_db, separator)
input_tam <- 50
total_list <- FALSE
position_artic <- seq(6, 35, 1)

# Call the function article_bib
lister_bibtex <- article_bib(input_date, input_tam, position_artic, total_list)
lister_bibtex

# Example 3 - Total list article

# File of database
file_db <- system.file("extdata","example_database.csv", package = "gerefer")
separator <- ","

# Parameters of the function
input_date <- example_database(file_db, separator)
input_tam <- 50
total_list <- TRUE
position_artic <- seq(1, input_tam, 1)

# Call the function article_bib
lister_bibtex <- article_bib(input_date, input_tam, position_artic, total_list)
lister_bibtex

Function that generates the test database

Description

The example_database function reads a csv file available on the computer system and returns a dataframe as an example of a database to be used by the functions of the bibliorefer package

Usage

example_database(path_date, separator)

Arguments

path_date

is a directory path containing the csv file

separator

is the separator for files in csv format

Value

This function return is a dataframe with database

References

Aria, M. & Cuccurullo, C. (2017) bibliometrix: An R-tool for comprehensive science mapping analysis, Journal of Informetrics, 11(4), pp 959-975, Elsevier

Examples

#Call the example_database function

file_db <- system.file("extdata","example_database.csv", package = "gerefer")
separator <- ","
date_sreference <- example_database(file_db, separator)
date_sreference

Article Information Organizer for specific standards formats.

Description

The redu_leter function provides a dataframe with a list of article titles, names of academic journals and names of publishers of the main scientific references, adapted to specific standards.The rules of some scientific journals establish that information, in relation to references, must have the first letter capitalized and the rest lowercase. The redu_leter function internally calls the principal_lister function, from the bibliorefer package, to generate the main list of scientific references. Then the article titles, names of academic journals and names of publishers are separated in a dataframe and undergo changes in the format of the letters. The first letter is transformed to the uppercase standard and the rest are transformed to the lowercase standard. The output of the function is a dataframe with titles, magazine names and publisher names in the formatting standard, which meets specific standards.

Usage

redu_leter(input_date, input_tam, position_artic, total_list)

Arguments

input_date

is a dataframe with the scientific production database obtained of colection WoS, Scopus and others

input_tam

is the length of the dataframe with the main scientifics articles, obtained using package bibliorefer.

position_artic

is a parameter that shows the positions of the articles in the main list, obtained using package bibliorefer, chosen to be included in the reference list of a scientific paper. If part of the list is used, the set of articles is presented through a sequence or a concatenated set. If the complete list is used, the complete sequence is created

total_list

is the parameter that defines whether all articles from the main list, obtained using package bibliorefer, will be used or not. This parameter contains the logical values TRUE or FALSE. If the full list is used, the value is TRUE. Otherwise, if a part of the list is used, the value is FALSE

Value

The redu_leter function provides a dataframe with a list of article titles, names of academic journals and names of publishers adapted to specific standards.

References

1 - Aria, M. & Cuccurullo, C. (2017) bibliometrix: An R-tool for comprehensive science mapping analysis, Journal of Informetrics, 11(4), pp 959-975, Elsevier. 2 - Mukherjee, Debmalya & Lim, Weng Marc & Kumar, Satish & Donthu, Naveen, 2022. "Guidelines for advancing theory and practice through bibliometric research," Journal of Business Research, Elsevier, vol. 148(C), pages 101-115.

Examples

# Example 1 - Concatenated position article

# File of database
file_db <- system.file("extdata","example_database.csv", package = "gerefer")
separator <- ","

# Parameters of the function
input_date <- example_database(file_db, separator)
input_tam <- 50
total_list <- FALSE
position_artic <- c(1, 2, 3, 5, 6, 8, 10, 12, 15, 17, 19, 23, 24,
     26, 28, 29, 30, 32, 33, 35, 36, 37, 38, 39, 40, 42, 44, 46, 47, 48)

#Calls the function redu_leter
especific_info <- redu_leter(input_date, input_tam, position_artic, total_list)
especific_info

# Example 2 - Position article in sequence

# File of database
file_db <- system.file("extdata","example_database.csv", package = "gerefer")
separator <- ","

# Parameters of the function
input_date <- example_database(file_db, separator)
input_tam <- 50
total_list <- FALSE
position_artic <- seq(6, 35, 1)

# Call the function redu_leter
especific_info <- redu_leter(input_date, input_tam, position_artic, total_list)
especific_info

# Example 3 - Total list article

# File of database
file_db <- system.file("extdata","example_database.csv", package = "gerefer")
separator <- ","

# Parameters of the function
input_date <- example_database(file_db, separator)
input_tam <- 50
total_list <- TRUE
position_artic <- seq(1, input_tam, 1)

# Call the function redu_leter
especific_info <- redu_leter(input_date, input_tam, position_artic, total_list)
especific_info