concstats

[schneiderpy]

Date accepted: 2023-03-17

Submitting Author Name: Name
Submitting Author Github Handle: @schneiderpy
Other Package Authors Github handles: (comma separated, delete if none)
Repository: https://github.com/schneiderpy/concstats
Version submitted:
Submission type: Stats
Badge grade: silver
Editor: @Paula-Moraga
Reviewers: @christopherkenny, @SebastianWojcik86

Due date for @christopherkenny: 2023-02-26

Due date for @SebastianWojcik86: 2023-02-28
Archive: TBD
Version accepted: TBD
Language: en

• Paste the full DESCRIPTION file inside a code block below:

Type: Package
Package: concstats
Title: Market Structure, Concentration and Inequality Measures
Version: 0.1.4
Authors@R: 
    person(given = "Andreas",
           family = "Schneider",
           role = c("aut", "cre"),
           email = "schneiderconsultingpy@gmail.com",
           comment = c(ORCID = "https://orcid.org/0000-0001-5630-1097"))
Description: Based on individual market shares of all participants in a
    market or space, the package offers a set of different structural and
    concentration measures frequently - and not so frequently - used in research
    and in practice. Measures can be calculated in groups or individually.
    The calculated measure or the resulting vector in table format should help
    practitioners make more informed decisions. Methods used in this package are
    from:
    1.  Chang, E. J., Guerra, S. M., de Souza Peñaloza, R. A. & Tabak, B. M.
    (2005) "Banking concentration: the Brazilian case".
    2.  Cobham, A. and A. Summer (2013). "Is It All About the Tails? The
    Palma Measure of Income Inequality".
    3.  García Alba Iduñate, P. (1994). "Un Indice de dominancia para el
    analisis de la estructura de los mercados".
    4.  Ginevicius, R. and S. Cirba (2009). "Additive measurement of market
    concentration" <doi:10.3846/1611-1699.2009.10.191-198>.
    5.  Herfindahl, O. C. (1950), "Concentration in the steel industry
    (PhD thesis)".
    6.  Hirschmann, A. O. (1945), "National power and structure of foreign trade".
    7.  Melnik, A., O. Shy, and R. Stenbacka (2008), "Assessing market dominance"
    <doi:10.1016/j.jebo.2008.03.010>.
    8.  Palma, J. G. (2006). "Globalizing Inequality: 'Centrifugal' and
    'Centripetal' Forces at Work".
    9.  Shannon, C. E. (1948). "A Mathematical Theory of Communication".
License: MIT + file LICENSE
URL: https://github.com/schneiderpy/concstats,
    https//schneiderpy.github.io/constats (website)
BugReports: https://github.com/schneiderpy/concstats/issues
Depends:
    R (>= 2.10)
Imports:
    dplyr (>= 1.0.7),
    readr
Suggests: 
    rmarkdown,
    knitr,
    devtools,
    kableExtra,
    ggplot2,
    testthat (>= 3.0.0),
    covr
VignetteBuilder:
    knitr,
    rmarkdown
Encoding: UTF-8
Language: en-US
LazyData: true
Roxygen: list(markdown = TRUE, roclets = c ("namespace", "rd", "srr::srr_stats_roclet"))
RoxygenNote: 7.2.1
Config/testthat/edition: 3

Scope

• Please indicate which of our statistical package categories this package falls under. (Please check one appropriate box below):

  Statistical Packages

  • Bayesian and Monte Carlo Routines
  • Dimensionality Reduction, Clustering, and Unsupervised Learning
  • Machine Learning
  • Regression and Supervised Learning
  • Exploratory Data Analysis (EDA) and Summary Statistics
  • Spatial Analyses
  • Time Series Analyses

Pre-submission Inquiry

• A pre-submission inquiry has been approved in Pre Submission of concstats #558

General Information

• Who is the target audience and what are scientific applications of this package?
  The goal of the concstats package is to offer a set of alternative and/or additional measures for researchers in social sciences and practitioners in institutions concerned with competition on a regular basis to better determine a given market structure and therefore reduce uncertainty with respect to a given market situation.

• Paste your responses to our General Standard G1.1 here, describing whether your software is:

  • The first implementation of a novel algorithm; or
  • The first implementation within R of an algorithm which has previously been implemented in other languages or contexts; or
  • An improvement on other implementations of similar algorithms in R.

  Please include hyperlinked references to all other relevant software.

Some functions are already implemented in other R packages. The non-exhaustive
summary below is by no means a description of each package.

• The Herfindahl Hirschman Index can be found in the hhi and the
  divseg packages. While the hhi package has just one function, neither of both packages offer a finite sample correction.

• The latter offers as well functions for the Entropy, Gini and Simpson measures.

• The acid and the ineq packages offer functions for inequality and competition measures, e.g. for the Entropy and Gini metric.

However, almost none of these packages offer finite sample correction, with the exception of the
ineq package.
Other functions are new implementations in R, e.g. Dominance Index, Palma ratio, Stenbacka Index, GRS measure, and the dual of the Herfindahl Hirschman Index.

• (If applicable) Does your package comply with our guidance around Ethics, Data Privacy and Human Subjects Research?
  Not applicable

Badging

• What grade of badge are you aiming for? (bronze, silver, gold)
  silver
• If aiming for silver or gold, describe which of the four aspects listed in the Guide for Authors chapter the package fulfils (at least one aspect for silver; three for gold)

• specific standards > 47%, and general standards > 58%
• fulfilling with two or more standards in the sub-categories 6.1.1, 6.1.2, and 6.1.5

Technical checks

Confirm each of the following by checking the box.

• I have read the rOpenSci packaging guide.
• I have read the author guide and I expect to maintain this package for at least 2 years or have another maintainer identified.
• I/we have read the Statistical Software Peer Review Guide for Authors.
• I/we have run autotest checks on the package, and ensured no tests fail.
• The srr_stats_pre_submit() function confirms this package may be submitted.
• The pkgcheck() function confirms this package may be submitted - alternatively, please explain reasons for any checks which your package is unable to pass.

This package:

• does not violate the Terms of Service of any service it interacts with.
• has a CRAN and OSI accepted license.
• contains a README with instructions for installing the development version.

Publication options

• Do you intend for this package to go on CRAN?
• Do you intend for this package to go on Bioconductor?

Code of conduct

• I agree to abide by rOpenSci's Code of Conduct during the review process and in maintaining my package should it be accepted.

[ropensci-review-bot]

Thanks for submitting to rOpenSci, our editors and @ropensci-review-bot will reply soon. Type @ropensci-review-bot help for help.

[ropensci-review-bot]

🚀

Editor check started

👋

[ropensci-review-bot]

Checks for concstats (v0.1.4)

git hash: d3e10c1a

• ✔️ Package is already on CRAN.
• ✔️ has a 'codemeta.json' file.
• ✔️ has a 'contributing' file.
• ✔️ uses 'roxygen2'.
• ✔️ 'DESCRIPTION' has a URL field.
• ✔️ 'DESCRIPTION' has a BugReports field.
• ✔️ Package has at least one HTML vignette
• ✔️ All functions have examples.
• ✔️ Package has continuous integration checks.
• ✔️ Package coverage is 99.2%.
• ✔️ R CMD check found no errors.
• ✔️ R CMD check found no warnings.

Package License: MIT + file LICENSE

---

1. rOpenSci Statistical Standards (srr package)

This package is in the following category:

• Exploratory Data Analysis

✔️ All applicable standards [v0.1.0] have been documented in this package (56 complied with; 46 N/A standards)

Click to see the report of author-reported standards compliance of the package with links to associated lines of code, which can be re-generated locally by running the srr_report() function from within a local clone of the repository.

---

2. Package Dependencies

Details of Package Dependency Usage (click to open)

The table below tallies all function calls to all packages ('ncalls'), both internal (r-base + recommended, along with the package itself), and external (imported and suggested packages). 'NA' values indicate packages to which no identified calls to R functions could be found. Note that these results are generated by an automated code-tagging system which may not be entirely accurate.

type	package	ncalls
internal	base	91
internal	concstats	43
internal	stats	5
imports	dplyr	NA
imports	readr	NA
suggests	rmarkdown	NA
suggests	knitr	NA
suggests	devtools	NA
suggests	kableExtra	NA
suggests	ggplot2	NA
suggests	testthat	NA
suggests	covr	NA
linking_to	NA	NA

Click below for tallies of functions used in each package. Locations of each call within this package may be generated locally by running 's <- pkgstats::pkgstats(<path/to/repo>)', and examining the 'external_calls' table.

base

as.numeric (28), sum (28), c (12), data.frame (7), cut (4), format (4), seq (4), log (2), length (1), seq_len (1)

concstats

concstats_firm (4), concstats_entropy (3), concstats_hhi (3), concstats_nrs_eq (3), concstats_palma (3), concstats_dom (2), concstats_gini (2), concstats_grs (2), concstats_hhi_d (2), concstats_hhi_min (2), concstats_simpson (2), concstats_sten (2), concstats_top (2), concstats_top3 (2), concstats_top5 (2), concstats_all_comp (1), concstats_all_inequ (1), concstats_all_mstruct (1), concstats_comp (1), concstats_concstats (1), concstats_inequ (1), concstats_mstruct (1)

stats

quantile (4), na.omit (1)

NOTE: No imported packages appear to have associated function calls; please ensure with author that these 'Imports' are listed appropriately.

---

3. Statistical Properties

This package features some noteworthy statistical properties which may need to be clarified by a handling editor prior to progressing.

Details of statistical properties (click to open)

The package has:

• code in R (100% in 6 files) and
• 1 authors
• 2 vignettes
• 1 internal data file
• 2 imported packages
• 22 exported functions (median 33 lines of code)
• 22 non-exported functions in R (median 44 lines of code)

---

Statistical properties of package structure as distributional percentiles in relation to all current CRAN packages
The following terminology is used:

• loc = "Lines of Code"
• fn = "function"
• exp/not_exp = exported / not exported

All parameters are explained as tooltips in the locally-rendered HTML version of this report generated by the checks_to_markdown() function

The final measure (fn_call_network_size) is the total number of calls between functions (in R), or more abstract relationships between code objects in other languages. Values are flagged as "noteworthy" when they lie in the upper or lower 5th percentile.

measure	value	percentile	noteworthy
files_R	6	40.3
files_vignettes	2	85.7
files_tests	5	81.7
loc_R	704	58.2
loc_vignettes	254	58.2
loc_tests	1266	90.0
num_vignettes	2	89.2
data_size_total	1301	61.1
data_size_median	1301	65.7
n_fns_r	44	52.5
n_fns_r_exported	22	70.1
n_fns_r_not_exported	22	43.6
n_fns_per_file_r	6	71.6
num_params_per_fn	2	11.9
loc_per_fn_r	38	84.2
loc_per_fn_r_exp	34	67.2
loc_per_fn_r_not_exp	44	88.4
rel_whitespace_R	17	58.1
rel_whitespace_vignettes	23	44.1
rel_whitespace_tests	14	83.6
doclines_per_fn_exp	63	75.1
doclines_per_fn_not_exp	0	0.0	TRUE
fn_call_network_size	33	57.5

---

3a. Network visualisation

Click to see the interactive network visualisation of calls between objects in package

---

4. goodpractice and other checks

Details of goodpractice checks (click to open)

3a. Continuous Integration Badges

GitHub Workflow Results

id	name	conclusion	sha	run_number	date
3329638517	pages build and deployment	success	d3e10c	53	2022-10-26
3329638614	pkgcheck	success	d3e10c	25	2022-10-26
3329638610	pkgdown	success	d3e10c	64	2022-10-26
3329638632	R-CMD-check	success	d3e10c	59	2022-10-26
3329638620	test-coverage	success	d3e10c	6	2022-10-26

---

3b. goodpractice results

R CMD check with rcmdcheck

rcmdcheck found no errors, warnings, or notes

Test coverage with covr

Package coverage: 99.19

Cyclocomplexity with cyclocomp

The following functions have cyclocomplexity >= 15:

function	cyclocomplexity
concstats_entropy	18
concstats_gini	18
concstats_hhi	18
concstats_simpson	18
concstats_sten	17

Static code analyses with lintr

lintr found the following 8 potential issues:

message	number of times
Avoid library() and require() calls in packages	8

---

Package Versions

package	version
pkgstats	0.1.1.54
pkgcheck	0.1.0.26
srr	0.0.1.180

---

Editor-in-Chief Instructions:

This package is in top shape and may be passed on to a handling editor

[mpadge]

@schneiderpy Our usual procedure is to first consider suitability in a pre-submission enquiry. You've opened #558 for that, so we'll close this until the conversation is resolved there. Once that is done, and if the pre-submission is approved, we can re-open this issue and move on from there. Thanks.

[adamhsparks]

Thanks, @schneiderpy, as @mpadge noted, usually we like to finalise the pre-submission inquiry before opening a request for a review, but everything seems to be in top shape, so I've reopened this and will start looking for a handling editor.

[annakrystalli]

Hello @schneiderpy 👋

Just wanted to give you a short update. We are still trying to find an appropriate editor to handle your submission and hoping to have found someone soon. Apologies for the delay!

[schneiderpy]

Thank you Anna for the update ... (by the way, I could not find the package in the latest newsletter (Software Review Section))

[annakrystalli]

Hello @schneiderpy. It's because it's still at review stage 0. It will appear in the newsletter when an editor is assigned and it reaches stage 1/editorial checks 😊

[schneiderpy]

Hello Anna, this is just a short email to find out if there is a chance the my package "concstats" will get reviewed (someday)? Best regards and an excellent 2023 Andreas Schneider [image: Mailtrack] <https://mailtrack.io?utm_source=gmail&utm_medium=signature&utm_campaign=signaturevirality11&> Remitente notificado con Mailtrack <https://mailtrack.io?utm_source=gmail&utm_medium=signature&utm_campaign=signaturevirality11&> 20/01/23, 12:27:20 El mar, 22 nov 2022 a las 10:25, Anna Krystalli ***@***.***>) escribió:

…

Hello @schneiderpy <https://github.com/schneiderpy>. It's because it's still at review stage 0. It will appear in the newsletter when an editor is assigned and it reaches stage 1/editorial checks 😊 — Reply to this email directly, view it on GitHub <#559 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/ASTA3FZ4ALF7F3LLSLPUJXDWJTCTHANCNFSM6AAAAAARQQEFRQ> . You are receiving this because you were mentioned.Message ID: ***@***.***>

[annakrystalli]

Dear @schneiderpy

Please accept our apologies for the delay and rest assured we are doing our best to find an appropriate editor. Hopefully we will be able to move the review forward by the end of the week.

[maurolepore]

Dear @schneiderpy,

Today starts my rotation as EiC -- meaning I now assume the role of @annakrystalli.

I'm watched the conversation here and among editors and it seems that the search for a handling editor continues. Thanks for your patience.