version 2011.08-1

CHANGELOG

@@ -2,6 +2,12 @@ CITAN PACKAGE CHANGELOG
 
 
 
+*******************************************************************************
+
+2011.08-1 /2011-08-11/
+   * Documentation cleanup.
+
+
 *******************************************************************************
 
 2011.05-1 /2011-05-14/

DESCRIPTION

@@ -1,26 +1,26 @@
 Package: CITAN
 License: LGPL (>= 3)
 Maintainer: Marek Gagolewski <gagolews@ibspan.waw.pl>
+BugReports:
+        http://r-forge.r-project.org/tracker/?atid=4279&group_id=1075
 LazyData: true
 Title: CITation ANalysis toolpack
 Type: Package
 Author: Marek Gagolewski <gagolews@ibspan.waw.pl>
 Description: CITAN is a library of functions useful in - but not
         limited to - quantitative research in the field of
         scientometrics. It contains various tools for preprocessing
-        bibliometric data retrieved e.g. from Elsevier's SciVerse
-        Scopus and calculating impact of individuals. Also, many
-        functions dealing with Pareto-Type II (GPD) and Discretized
-        Pareto-Type II statistical models are included (e.g.
-        Zhang-Stephens and MLE estimators, goodness-of-fit and
+        bibliographic data retrieved e.g. from Elsevier's SciVerse
+        Scopus and calculating bibliometric impact of individuals.
+        Also, many functions dealing with Pareto-Type II (GPD) and
+        Discretized Pareto-Type II statistical models are included
+        (e.g. Zhang-Stephens and MLE estimators, goodness-of-fit and
         two-sample tests, confidence intervals for the theoretical
         Hirsch index etc.). They may be used to describe and analyze
         many phenomena encountered in the social sciences.
-Author@R: c(person("Marek", "Gagolewski", email =
-        "gagolews@ibspan.waw.pl"))
-Version: 2011.05-1
-URL: http://CRAN.R-project.org/package=CITAN
-Date: 2011-05-14
+Version: 2011.08-1
+URL: http://www.ibspan.waw.pl/~gagolews/CITAN/
+Date: 2011-08-11
 Depends: R (>= 2.10.0), DBI, RSQLite, RGtk2, hash, ADGofTest
 Collate: 'biblio.internal.R' 'biblio.assess.R' 'biblio.clear.R'
         'biblio.connect.R' 'biblio.create.R' 'biblio.duplicates.R'
@@ -33,6 +33,6 @@ Collate: 'biblio.internal.R' 'biblio.assess.R' 'biblio.clear.R'
         'p2.ftest.R' 'p2.goftest.R' 'p2.htest.approx.R' 'p2.htest.R'
         'rgtk2.R' 'rho.R' 'scopus.data.R' 'scopus.importsources.R'
         'scopus.readcsv.R' 'string.R'
-Packaged: 2011-05-14 09:40:44 UTC; gagolews
+Packaged: 2011-08-11 18:59:25 UTC; gagolews
 Repository: CRAN
-Date/Publication: 2011-05-15 07:29:07
+Date/Publication: 2011-08-12 05:08:34

MD5

@@ -0,0 +1,123 @@
+a728b57c3abb72527087a71adf584999 *CHANGELOG
+47a0bee3bdef7622cb5c6ad03bd2ad53 *DESCRIPTION
+e6a600fd5e1d9cbde2d983680233ad02 *LICENSE
+21c26a7bbeeae0893c4a2d8bb1bbbeee *NAMESPACE
+e1b6f64e7758bd48b78ce7cb5acc4f37 *R/CITAN-package.R
+df69678bc72bc032e6a28ae16a97af97 *R/biblio.assess.R
+e7fc0acbb114fcee468b66ccf0065296 *R/biblio.clear.R
+5cc54ffc07990b7d008b93cde2763544 *R/biblio.connect.R
+3a21406369d2b3bc121c89b26a118c88 *R/biblio.create.R
+4a685248a9f38fcc971a409e22acc85f *R/biblio.duplicates.R
+360230eeedefb26d1350dc7f3f837ab8 *R/biblio.getcitations.R
+c9a5738be812649f34e0a0dd6b88fed4 *R/biblio.import.R
+4dd7e0bd896eeef02e6a880ea11b5b01 *R/biblio.info.R
+2bea2b195cec34cd1351ac86f39f408e *R/biblio.internal.R
+b21c7973fdf289c9e4fde4991f5d90c6 *R/biblio.search.R
+f1165e0a2002a65863245b7c1016f648 *R/biblio.stats.R
+e2fdbdf8989daa6a32c63ea76f44c58d *R/distrib_hirsch.R
+6b9ea3b767197c476fea06a5598e0bd1 *R/distrib_p2.R
+93783c14326631af09eec7395a24ee19 *R/distrib_sstat.R
+bba6e7b20b6f8028b947fbac45aaab4e *R/dp2.estimate.R
+a59a61798e72f9736f604453e8966049 *R/dp2.goftest.R
+30546932c92f34c731f9cda3bc26257e *R/execquery.R
+a4fc8c7c507d1d2d1d0ca56f69f13064 *R/impact_functions.R
+0a3977157de78673d5c935a3ecc5e162 *R/impact_visualization.R
+18cceb76dcb61630636191c967ff0d57 *R/p2.confint.h.R
+d46e6ec6d49f2aa209f47c7e21d737dc *R/p2.confint.rho.R
+57e8294a14cfb59557539bc173000f8c *R/p2.confint.rho.approx.R
+379bb8d2f5d6ad54c55c669432260121 *R/p2.estimate.R
+a00a53169cd7dcfcd136b9e1a764dd55 *R/p2.ftest.R
+ab2b6d5bf26ea4f0d2758d0f44f84632 *R/p2.goftest.R
+1afb5df7fc304fdd3df9368682f9b903 *R/p2.htest.R
+7a9a99fa5cffad8432ff1259277e28e9 *R/p2.htest.approx.R
+823756f23a31b33d8b59612d442f61ad *R/rgtk2.R
+918b3f8d326d3651bf11d643234f4584 *R/rho.R
+5c6c74fd03b7060895024e987f013b85 *R/scopus.data.R
+7913818f762678fe9fe4b5800c8bc2cb *R/scopus.importsources.R
+d03bd7cccd36336f2aeaf8cdaa4d1772 *R/scopus.readcsv.R
+f15c95e6600e15259940f3684f20877c *R/string.R
+e9660b22d4457ab95fff86deebcc60d8 *data/Scopus_ASJC.rda
+ce2d2ae43e5f5b69e3cff664729c60b0 *data/Scopus_SourceList.rda
+718531f762875c75e866568a10d84405 *data/datalist
+7c4cb35097021a9dee3c76b54a350621 *inst/CITATION
+e6a600fd5e1d9cbde2d983680233ad02 *inst/LICENSE
+4a4d0d43653b842700aa03744222cfa3 *inst/doc/CITAN-lbs.pdf
+3eeb7951d7ae0da92152f01da38dc9c4 *inst/doc/CITAN-lbs.png
+2e4680244ce4d00a0be8cbc330fe39fc *inst/doc/index.html
+92816ca3a99d5c115b0002445de6af34 *man/CITAN-package.Rd
+d4409250214883b1a78739ae7d51906a *man/Scopus_ASJC.Rd
+b565232ddf708b4b943238a7e5d23b4d *man/Scopus_ImportSources.Rd
+0682c767879b1ccfbcca38e67b9f1229 *man/Scopus_ReadCSV.Rd
+bf9401e577fcb75f648a768f15bc4a4e *man/Scopus_SourceList.Rd
+411378b22dc92f1a0e1880234511baf8 *man/Sstat.Rd
+ab779e591a088d8640e830a3cad00397 *man/Sstat2.Rd
+19b4b4fb5cb45bb7d741cd2712ab4398 *man/as.character.authorinfo.Rd
+daaeeb026a6ce3e0b781cace40be9c67 *man/as.character.docinfo.Rd
+3727d0889a0105f23f654404b8fee008 *man/curve.add.lp.Rd
+6facb8dcb7220ef2a30825e3166fe8d5 *man/curve.add.rp.Rd
+a0a057b6352275b559b7c3bdb800b0f4 *man/dbExecQuery.Rd
+1d9741b4aad44b5b4e388a3882ebb4bb *man/dhirsch.Rd
+931006f1b5902756850be565a6f03a6b *man/discrpareto2.goftest.Rd
+8a3b06f01237de2ad27ecbeb1aa87e3b *man/discrpareto2.mlekestimate.Rd
+c24dfef377184be0acc96cc378507efd *man/discrpareto2.mleksestimate.Rd
+24f577e39ee58f72aea36e9e9beeed0a *man/dpareto2.Rd
+ff15ee24dde01c82d4f29420a9cfbc7b *man/dsstat.Rd
+e9624694528eed94fd93ef6979e7432f *man/index.g.Rd
+da801ce198c0fdee74d1813e1f1ca65c *man/index.h.Rd
+e96ac771ddca747fc8d961cf4ec5a136 *man/index.lp.Rd
+8bc639c9bb77a17ef41af799e1785ebf *man/index.rp.Rd
+52a7137ac811872dfd040db4c21a4a5b *man/lbsAssess.Rd
+c2b18e40ddf5d1368b15fcbc79cfbff2 *man/lbsClear.Rd
+a726ac179fdb83a042866d4b1ca41972 *man/lbsConnect.Rd
+d86787349b453c3a6837ab24cc64d6d6 *man/lbsCreate.Rd
+32a1d86e9cc6424c015c056d34e681fd *man/lbsDeleteAllAuthorsDocuments.Rd
+6b4a57ccc233bb7fb69410c39713b10d *man/lbsDeleteDocuments.Rd
+58ae36feb349fcd4fe679c84b3b4e8c0 *man/lbsDescriptiveStats.Rd
+dc7ced2895387c0e233ad9b838081cc9 *man/lbsFindDuplicateAuthors.Rd
+28aff3071c4fe5d40a533b45ff138f3a *man/lbsFindDuplicateTitles.Rd
+4924434f203e3bb13075d20c093049fb *man/lbsGetCitations.Rd
+aad8064be4b6bc6bf8a3e14f47747fc9 *man/lbsGetInfoAuthors.Rd
+a8dbca3cdf43274527d9a95393195e67 *man/lbsGetInfoDocuments.Rd
+0fef5fa3f5775054f21592890459bd3e *man/lbsImportDocuments.Rd
+57db4bcd3cb755093c36e23c7f473177 *man/lbsMergeAuthors.Rd
+15bfd51fc61aab487b762e81eb53758f *man/lbsSearchAuthors.Rd
+bb144610f3d8457059e5c454b0a909e0 *man/lbsSearchDocuments.Rd
+cd29aa4e53b8fcbf0bcb723e698cec5e *man/lbsTidy.Rd
+9965085abf2a7f78cfc9dbbe1aa07099 *man/pareto2.confint.h.Rd
+333ec0b0ebbe4729d337d44f5419b50b *man/pareto2.confint.h.lower.Rd
+ddcbf02626e5c26b7f2d4e473b4bf133 *man/pareto2.confint.h.upper.Rd
+5f0d67cac709ab7d8126965fd433bf09 *man/pareto2.confint.rho.Rd
+0ad68cac42688a26423a1ce4e28616be *man/pareto2.confint.rho.approx.Rd
+a9e00b9f04edc56c7ffbb1766a4f9ded *man/pareto2.confint.rho.approx.lower.Rd
+7f427d0ac3820821a65cb71a2f628af2 *man/pareto2.confint.rho.approx.upper.Rd
+4862150ef491e3c675ac21d3d1473522 *man/pareto2.confint.rho.lower.Rd
+389f8ac25d8e2849ae41e85561a6bff5 *man/pareto2.confint.rho.upper.Rd
+17ca390d13842e4984a03e88af08921a *man/pareto2.dhirsch.Rd
+2f035cd577d45cd2413cf91439e92041 *man/pareto2.ftest.Rd
+c8d97b54dd4f882a395e6c54a0377921 *man/pareto2.goftest.Rd
+a5fef350c94f86d8fc227abdaa311213 *man/pareto2.htest.Rd
+84c92551b0c589548c2fb1bf12f18d65 *man/pareto2.htest.approx.Rd
+3fceb13dae248caf10967af4fcdf05a7 *man/pareto2.mlekestimate.Rd
+4b8a3e2ff3a2b099efcc476e203666fc *man/pareto2.mleksestimate.Rd
+b0dce3b20ee2c30854a51058f3b1e474 *man/pareto2.phirsch.Rd
+619169b81f49af9e9e86f9160f9fac86 *man/pareto2.zsestimate.Rd
+7a7cfd584fcca79bee19b6c5324f2d26 *man/phirsch.Rd
+2066148c628fb245ea1a0348ca4b768e *man/plot.citfun.Rd
+8e68f654804b2aa0f9cfeaa74016a90a *man/ppareto2.Rd
+eb9f5d5c26124d49c957297deba73d62 *man/print.authorinfo.Rd
+134f55e8524d950e8cca8201ba20ff3b *man/print.docinfo.Rd
+fa6459b36f4dc7838df55eab60807a00 *man/psstat.Rd
+92e320bd121b8b801331d265ca0711b5 *man/qpareto2.Rd
+77beebbc70c96a9a29314a46c28a7539 *man/rho.get.Rd
+544e29261e35292206636f10511140ac *man/rpareto2.Rd
+24938ad904c0780c70251f95f5d3072e *man/sqlEscape.Rd
+6688fee0f8478b77be61515669fdc21d *man/sqlEscapeTrim.Rd
+71b25a32f8e639a47bf3e47bfc0c4ff5 *man/sqlNumericOrNULL.Rd
+521330c2eb4bd68fff12008b171fa0f6 *man/sqlStringOrNULL.Rd
+bfd94711154742df0722c33f9f6c32ba *man/sqlSwitchOrNULL.Rd
+12c8906fb4ed9fdae47d580297bf6106 *man/sqlTrim.Rd
+79dbbe22c4aa09ffc05cb702cb11a841 *src/CITAN.c
+ca654dd5b6129abbbfcb9974ec1f14c6 *src/impact_functions.c
+ce7d24fd867d00cb9a98c13dc478c943 *src/impact_functions.h
+2f63235f4f8fc165e51b830b6999d281 *src/pareto2.c
+100bb4536cf7e1e217f6aee588c45160 *src/pareto2.h

R/CITAN-package.R

@@ -20,8 +20,8 @@
 #' \pkg{CITAN} is a library of functions useful in --- but not limited to ---
 #' quantitative research in the field of scientometrics.
 #' It contains various tools for preprocessing 
-#' bibliometric data retrieved e.g. from Elsevier's \emph{SciVerse Scopus} and
-#' calculating impact of individuals.
+#' bibliographic data retrieved e.g. from Elsevier's \emph{SciVerse Scopus} and
+#' calculating bibliometric impact of individuals.
 #' Also, many functions dealing with Pareto-Type II (GPD)
 #' and Discretized Pareto-Type II statistical models
 #' are included (e.g. Zhang-Stephens and MLE estimators,
@@ -37,20 +37,19 @@
 #' of some publication-citation process
 #' characteristics is assumed to be a predictor of broadly conceived
 #' scientific competence. It may be used e.g. in building decision support
-#' systems for science quality control.
+#' systems for scientific quality control.
 #'
 #' The \eqn{h}-index, proposed by J.E. Hirsch (2005)
 #' is among the most popular scientific impact indicators.
 #' An author who has published \eqn{n}
 #' papers has the Hirsch index equal to \eqn{H}, if each of his \eqn{H}
 #' publications were cited at least \eqn{H} times, and each of the
-#' other \eqn{n-H} items were cited no more than \eqn{H} times. This simple
-#' bibliometric tool
-#' quickly received much attention in the academic community
+#' remaining \eqn{n-H} items were cited no more than \eqn{H} times. This simple
+#' bibliometric tool quickly received much attention in the academic community
 #' and started to be a subject of intensive
 #' research. It was noted that, contrary to earlier approaches,
-#' i.e. publication count, citation count etc.,
-#' this measure both concerns productivity and impact of an
+#' i.e. publication count, citation count, etc.,
+#' this measure  concerns both productivity and impact of an
 #' individual.
 #' \cr
 #'
@@ -115,7 +114,7 @@
 #' }
 #'
 #' \strong{(2)}
-#' To \bold{preprocess and analyze bibliometric data} retrieved
+#' To \bold{preprocess and analyze bibliometric data} (cf. Gagolewski, 2011) retrieved
 #' e.g. from Elsevier's \emph{SciVerse Scopus}
 #' we need the \pkg{RSQLite} package. It is an interface to the free
 #' SQLite DataBase Management System (see \url{http://www.sqlite.org/}).
@@ -154,11 +153,11 @@
 #'
 #' \strong{(3)}
 #' Additionally, a set of \bold{functions dealing with stochastic aspects
-#' of S-statistics, the \eqn{h}-index} and the Pareto type-II statistical models
+#' of S-statistics (generalized OWMax operators), the \eqn{h}-index} and the Pareto type-II statistical models
 #' is included (Gagolewski, Grzegorzewski, 2010a). We have the following.
 #' \itemize{
 #' \item Functions that work for any continuous distribution
-#' (see Gagolewski, Grzegorzewski, 2010a):
+#' (cf. Gagolewski, Grzegorzewski, 2010a):
 #' \enumerate{
 #'    \item \code{\link{psstat}}, \code{\link{dsstat}} for computing
 #'         the distribution of S-statistics generated by some control function,
@@ -234,12 +233,15 @@
 #' @title CITation ANalysis toolpack
 #' @author Marek Gagolewski \email{gagolews@@ibspan.waw.pl}
 #' @references
+#' CITAN homepage, \url{http://www.ibspan.waw.pl/~gagolews/CITAN/}\cr
 #' GTK+ Project, \url{http://www.gtk.org/download.html}\cr
 #' SQLite DBMS, \url{http://www.sqlite.org/}\cr
 #' Dubois D., Prade H., Testemale C., Weighted fuzzy pattern matching,
 #'    Fuzzy Sets and Systems 28, s. 313-331, 1988.\cr
 #' Egghe L., Theory and practise of the g-index, Scientometrics 69(1),
 #'    131-152, 2006.\cr
+#' Gagolewski M., Bibliometric Impact Assessment with R and the CITAN Package,
+#' Journal of Informetrics, 2011, doi:10.1016/j.joi.2011.06.006.\cr
 #' Gagolewski M., Grzegorzewski P., Possibilistic analysis of arity-monotonic
 #'    aggregation operators and its relation to bibliometric impact assessment
 #'    of individuals, International Journal of Approximate Reasoning, 2011,

R/biblio.assess.R

@@ -111,7 +111,7 @@ lbsAssess <- function(citseq, f=list(length, index.h), captions=c("length", "ind
 		wh <- numeric(0);
 		for (i in 1:length(f))
 		{
-			wh <- c(wh, which(rank(-result[,i+1],ties="min")<=bestRanks));
+			wh <- c(wh, which(rank(-result[,i+1],ties.method="min")<=bestRanks));
 		}
 		return(result[unique(sort(wh,decreasing=TRUE)),]);
 	} else return(result);

R/biblio.stats.R

@@ -252,7 +252,7 @@ lbsDescriptiveStats <- function(conn,
 
 	if (show[1L])
 	{
-		tab <- sort(table(res$Type), dec=TRUE);
+		tab <- sort(table(res$Type), decreasing=TRUE);
 		barplot(tab, main=main, ...);
 		mtext(as.graphicsAnnot(captions[1]), 3, 0.25, cex=cex.caption);
 

inst/CITATION

@@ -0,0 +1,18 @@
+citHeader("To cite package 'CITAN' in publications use:")
+
+citEntry(entry = "Article",
+  title        = "Bibliometric impact assessment with {R} and the {CITAN} package",
+  author       = personList(as.person("Marek Gagolewski")),
+  journal      = "Journal of Informetrics",
+  year         = "2011",
+#  volume       = "37",
+#  number       = "8",
+#  pages        = "1--52",
+  url          = "http://www.ibspan.waw.pl/~gagolews/CITAN/",
+  doi          = "10.1016/j.joi.2011.06.006",
+
+  textVersion  =
+  paste("Marek Gagolewski (2011).",
+        "Bibliometric impact assessment with R and the CITAN package.",
+        "Journal of Informetrics. In press, doi:10.1016/j.joi.2011.06.006.")
+)