instrument_data.R

#' Child and Adolescent Interpersonal Survey
#'
#' Information about the Child and Adolescent Interpersonal Survey (CAIS).
#'
#' @section Note on the withdrawn second normative sample:
#' The package ships one CAIS normative sample, the child sample. A second,
#' drawn from the source's adult respondents, was shipped until version 2.0.0
#' and has been withdrawn. The CAIS is rated on a 5-point scale, but three of
#' the octant means the source publishes for those respondents fall above 5, so
#' that sample cannot be on the same metric as the scores it would standardize:
#' `norm_standardize()` refused it, which left it as data no call could use.
#' The transcription was faithful and the source's own table is the origin of
#' the discrepancy, so the values are not lost — they are recorded, with the
#' evidence about what went wrong in the source and what a reply from its
#' authors would reopen, in the package's source repository under
#' `cairn/references/sodano2006.md`, which also records the state of the query
#' to the source's authors.
#'
#' @source Sodano, S. M., & Tracey, T. J. G. (2006). Interpersonal traits in
#'   childhood: Development of the Child and Adolescent Interpersonal Survey.
#'   *Journal of Personality Assessment, 87*(3), 317–329.
#' @source \doi{10.1207/s15327752jpa8703_12}
#' @keywords internal
#' @examples
#' summary(cais)
#' scales(cais, items = TRUE)
"cais"


#' Circumplex Scales of Interpersonal Efficacy
#'
#' Information about the Circumplex Scales of Interpersonal Efficacy (CSIE).
#'
#' @source Locke, K. D., & Sadler, P. (2007). Self-efficacy, values, and
#'   complementarity in dyadic interactions: Integrating interpersonal and
#'   social-cognitive theory. *Personality and Social Psychology Bulletin,
#'   33*(1), 94-109. The normative sample below is this article's Study 1
#'   sample, but the octant means and standard deviations themselves are
#'   published in the author's norms table, not in the article:
#'   \url{https://kennethlocke.org/CSIE/CSIE_Norms.html}
#' @source \url{https://kennethlocke.org/CSIE/CSIE.html}
#' @keywords internal
#' @examples
#' summary(csie)
#' scales(csie, items = TRUE)
"csie"

#' Circumplex Scales of Intergroup Goals
#'
#' Information about the Circumplex Scales of Intergroup Goals (CSIG).
#'
#' @source Locke, K. D. (2014). Circumplex scales of intergroup goals: An
#'   interpersonal circle model of goals for interactions between groups.
#'   *Personality and Social Psychology Bulletin, 40*(4), 433-449.
#' @source \url{https://kennethlocke.org/CSIG/CSIG.html}
#' @keywords internal
#' @examples
#' summary(csig)
#' scales(csig, items = TRUE)
"csig"

#' Circumplex Scales of Interpersonal Problems
#'
#' Information about the Circumplex Scales of Interpersonal Problems (CSIP).
#'
#' @source Boudreaux, M. J., Ozer, D. J., Oltmanns, T. F., & Wright, A. G. C.
#'   (2018). Development and validation of the circumplex scales of
#'   interpersonal problems. *Psychological Assessment, 30*(5), 594-609.
#' @source \doi{10.1037/pas0000505}
#' @keywords internal
#' @examples
#' summary(csip)
#' scales(csip, items = TRUE)
"csip"

#' Circumplex Scales of Interpersonal Values
#'
#' Information about the Circumplex Scales of Interpersonal Values (CSIV).
#'
#' @source Locke, K. D. (2000). Circumplex scales of interpersonal values:
#'   Reliability, validity, and applicability to interpersonal problems and
#'   personality disorders. *Journal of Personality Assessment, 75*(2), 249-267.
#'   This article defines the instrument; it reports no octant means or
#'   standard deviations, and its samples are not the normative sample below.
#' @source Norms: Locke, K. D. (n.d.). *CSIV norms* \[unpublished data\]. The
#'   shipped octant means and standard deviations, and the N of 1,200, come
#'   from the author's norms table:
#'   \url{https://kennethlocke.org/CSIV/CSIV_Norms.html}
#' @source \url{https://kennethlocke.org/CSIV/CSIV.html}
#' @keywords internal
#' @examples
#' summary(csiv)
#' scales(csiv, items = TRUE)
"csiv"

#' Interpersonal Emotion Inventory
#'
#' Information about the Interpersonal Emotion Inventory (IEI).
#'
#' @source Horner, M. S., Locke, K. D., & Hulsey, T. L. (2025). Assessing
#'   affective dimensions of the interpersonal circumplex: Development and
#'   validation of the Interpersonal Emotion Inventory. *Journal of Personality
#'   Assessment, 107*(2), 170-187. First published online 13 September 2024.
#' @source \doi{10.1080/00223891.2024.2400266}
#' @source \url{https://kennethlocke.org/IEI/IEI.html}
#' @keywords internal
#' @examples
#' summary(iei)
#' scales(iei, items = TRUE)
"iei"

#' Interpersonal Goals Inventory for Children, Revised Version
#'
#' Information about the Interpersonal Goals Inventory for Children, Revised
#' Version (IGI-CR).
#'
#' @source Trucco, E. M., Wright, A. G. C., & Colder, C. R. (2013). A revised
#'   interpersonal circumplex inventory of children’s social goals. *Assessment,
#'   20*(1), 98-113.
#' @source \doi{10.1177/1073191111411672}
#' @keywords internal
#' @examples
#' summary(igicr)
#' scales(igicr, items = TRUE)
"igicr"

#' Inventory of Interpersonal Problems, Brief Version
#'
#' Information about the Inventory of Interpersonal Problems, Brief Version
#' (IIP-32). Note that, although we have permission to provide some information
#' about the IIP-32, Mind Garden Inc. has exclusive rights to distribute it in
#' full.
#'
#' The normative means and standard deviations are the manual's Table F.5
#' (p. 91), divided by 4 to express the printed four-item scale sums as item
#' means. They are reproduced under the credit line the publisher's permission
#' requires:
#'
#' "Reproduction by special permission of the Publisher, Mind Garden, Inc.,
#' www.mindgarden.com from the Inventory of Interpersonal Problems by Leonard M.
#' Horowitz, Lynn E. Alden, Jerry S. Wiggins, & Aaron L. Pincus. Copyright ©
#' 2000 by Leonard M. Horowitz, Lynn E. Alden, Jerry S. Wiggins, & Aaron L.
#' Pincus. Further Reproduction is prohibited without the Publisher's written
#' consent."
#'
#' That credit line is the publisher's own required wording, reproduced
#' verbatim; its 2000 copyright date is part of that wording and is not the
#' edition the values come from, which is the 2003 third edition cited below.
#'
#' @source Horowitz, L. M., Alden, L. E., Wiggins, J. S., & Pincus, A. L.
#'   (2003). *Inventory of Interpersonal Problems manual: Includes IIP-64 and
#'   IIP-32 forms* (3rd ed.). Menlo Park, CA: Mind Garden. Originally published
#'   by The Psychological Corporation; the shipped values are verified against
#'   this third edition.
#' @source \url{https://www.mindgarden.com/113-inventory-of-interpersonal-problems}
#' @keywords internal
#' @examples
#' summary(iip32)
"iip32"

#' Inventory of Interpersonal Problems
#'
#' Information about the Inventory of Interpersonal Problems (IIP-64). Note
#' that, although we have permission to provide some information about the
#' IIP-64, Mind Garden Inc. has exclusive rights to distribute it in full.
#'
#' The normative means and standard deviations are the manual's Table 4.4
#' (pp. 27-29), divided by 8 to express the printed eight-item scale sums as
#' item means. They are reproduced under the credit line the publisher's
#' permission requires:
#'
#' "Reproduction by special permission of the Publisher, Mind Garden, Inc.,
#' www.mindgarden.com from the Inventory of Interpersonal Problems by Leonard M.
#' Horowitz, Lynn E. Alden, Jerry S. Wiggins, & Aaron L. Pincus. Copyright ©
#' 2000 by Leonard M. Horowitz, Lynn E. Alden, Jerry S. Wiggins, & Aaron L.
#' Pincus. Further Reproduction is prohibited without the Publisher's written
#' consent."
#'
#' That credit line is the publisher's own required wording, reproduced
#' verbatim; its 2000 copyright date is part of that wording and is not the
#' edition the values come from, which is the 2003 third edition cited below.
#'
#' @source Horowitz, L. M., Alden, L. E., Wiggins, J. S., & Pincus, A. L.
#'   (2003). *Inventory of Interpersonal Problems manual: Includes IIP-64 and
#'   IIP-32 forms* (3rd ed.). Menlo Park, CA: Mind Garden. Originally published
#'   by The Psychological Corporation; the shipped values are verified against
#'   this third edition.
#' @source \url{https://www.mindgarden.com/113-inventory-of-interpersonal-problems}
#' @keywords internal
#' @examples
#' summary(iip64)
"iip64"

#' Inventory of Interpersonal Problems, Short Circumplex
#'
#' Information about the Inventory of Interpersonal Problems Short Circumplex
#' (IIP-SC).
#'
#' @source Soldz, S., Budman, S., Demby, A., & Merry, J. (1995). A short form of
#'   the Inventory of Interpersonal Problems Circumplex Scales. *Assessment,
#'   2*(1), 53-63. This article constructed the IIP-SC and is the source of the
#'   outpatient normative sample below.
#' @source Hopwood, C. J., Pincus, A. L., DeMoor, R. M., & Koonce, E. A. (2008).
#'   Psychometric characteristics of the Inventory of Interpersonal
#'   Problems-Short Circumplex (IIP-SC) with college students. *Journal of
#'   Personality Assessment, 90*(6), 615-618. The source of the college-student
#'   normative sample below.
#' @source \doi{10.1080/00223890802388665}
#' @keywords internal
#' @examples
#' summary(iipsc)
"iipsc"

#' Inventory of Interpersonal Strengths, Brief Version
#'
#' Information about the Inventory of Interpersonal Strengths, Brief Version
#' (IIS-32).
#'
#' @source Hatcher, R. L., & Rogers, D. T. (2012). The IIS-32: A brief inventory
#'   of interpersonal strengths. *Journal of Personality Assessment, 94*(6),
#'   638-646. This article defines the instrument and supplies the
#'   item-to-octant grouping (Appendix, p. 646); it reports no octant means or
#'   standard deviations, and none of its samples is the normative sample below.
#' @source Norms: source unconfirmed. The shipped octant means and standard
#'   deviations, the N of 1380, and the sample description that accompanies
#'   them are published in no source that has been identified, including the
#'   article above. Treat them as unverified until a source is established.
#' @source \doi{10.1080/00223891.2012.681818}
#' @keywords internal
#' @examples
#' summary(iis32)
#' scales(iis32, items = TRUE)
"iis32"

#' Inventory of Interpersonal Strengths
#'
#' Information about the Inventory of Interpersonal Strengths (IIS-64).
#'
#' @source Hatcher, R. L., & Rogers, D. T. (2009). Development and validation of
#'   a measure of interpersonal strengths: The Inventory of Interpersonal
#'   Strengths. *Psychological Assessment, 21*(4), 554-569.
#' @source \doi{10.1037/a0017269}
#' @keywords internal
#' @examples
#' summary(iis64)
#' scales(iis64, items = TRUE)
"iis64"

#' Inventory of Influence Tactics Circumplex
#'
#' Information about the Inventory of Influence Tactics Circumplex (IIT-C).
#'
#' @source Bliton, C. F., & Pincus, A. L. (2020). Construction and validation
#'   of the Interpersonal Influence Tactics Circumplex (IIT-C) Scales.
#'   *Assessment, 27*(4), 688-705. First published online 25 July 2019, which is
#'   the version the shipped norms credit as Bliton & Pincus (2019).
#' @source \doi{10.1177/1073191119864661}
#' @keywords internal
#' @examples
#' summary(iitc)
#' scales(iitc, items = TRUE)
"iitc"

#' IPIP Interpersonal Circumplex
#'
#' Information about the IPIP Interpersonal Circumplex (IPIP-IPC).
#'
#' @source Markey, P. M., & Markey, C. N. (2009). A brief assessment of the
#'   interpersonal circumplex: The IPIP-IPC. *Assessment, 16*(4), 352-361. This
#'   article defines the instrument and supplies its item-to-octant assignment
#'   and response anchors (Appendix, p. 360); the only octant means and standard
#'   deviations it reports are for a different sample (Study 1 combined,
#'   p. 354).
#' @source Norms: source unconfirmed. The shipped octant means and standard
#'   deviations are published in no source that has been identified. The sample
#'   size of 274 is the article's Study 2 (p. 357), for which the article
#'   reports no descriptive statistics. Treat them as unverified until a source
#'   is established.
#' @source \doi{10.1177/1073191109340382}
#' @keywords internal
#' @examples
#' summary(ipipipc)
#' scales(ipipipc, items = TRUE)
"ipipipc"

#' Interpersonal Sensitivities Circumplex
#'
#' Information about the Interpersonal Sensitivities Circumplex (ISC).
#'
#' @source Hopwood, C. J., Ansell, E. B., Pincus, A. L., Wright, A. G. C.,
#'   Lukowitsky, M. R., & Roche, M. J. (2011). The circumplex structure of
#'   interpersonal sensitivities. *Journal of Personality, 79*(4), 707-740.
#' @source \doi{10.1111/j.1467-6494.2011.00696.x}
#' @keywords internal
#' @examples
#' summary(isc)
#' scales(isc, items = TRUE)
"isc"