academic: Academic widgets

In tarakc02/discoveryengine: A CADS Prospecting Tool

Academic widgets

Description

Find entities who graduated with a particular major(s) or from a particular school(s). By default, attendees are not included, use attendees = TRUE to include attendees. If no majors/schools are entered, the widget will look for anyone with a Cal degree (or if attendees = TRUE, anyone who has attended Cal). Will not retrieve anyone with non-Berkeley degrees.

Usage

has_degree_from_department(
  ...,
  undergraduates = TRUE,
  graduates = TRUE,
  attendees = FALSE,
  current_students = FALSE,
  degreeholders = TRUE,
  from = NULL,
  to = NULL,
  advisor = NULL
)

has_degree_from(
  ...,
  undergraduates = TRUE,
  graduates = TRUE,
  attendees = FALSE,
  current_students = FALSE,
  degreeholders = TRUE,
  from = NULL,
  to = NULL,
  advisor = NULL
)

has_degree(
  ...,
  attendees = FALSE,
  current_students = FALSE,
  degreeholders = TRUE,
  from = NULL,
  to = NULL,
  advisor = NULL
)

majored_in(
  ...,
  undergraduates = TRUE,
  graduates = TRUE,
  attendees = FALSE,
  current_students = FALSE,
  degreeholders = TRUE,
  from = NULL,
  to = NULL,
  advisor = NULL
)

minored_in(
  ...,
  undergraduates = TRUE,
  graduates = TRUE,
  attendees = FALSE,
  current_students = FALSE,
  degreeholders = TRUE,
  from = NULL,
  to = NULL,
  advisor = NULL
)

Arguments

...	Schools/majors
undergraduates	TRUE/FALSE: should include undergraduates? Default is TRUE
graduates	TRUE/FALSE: should include graduates? Default is TRUE
attendees	TRUE/FALSE: should include attendees? Default is FALSE
current_students	TRUE/FALSE: should include current students? Default is FALSE
degreeholders	TRUE/FALSE: should include degreeholders? Default is TRUE
from	(optional) date range: look only for those who graduated between these dates. Enter as an integer of the form YYYYMMDD (see details)
to	(optional) date range: look only for those who graduated between these dates. Enter as an integer of the form YYYYMMDD (see details)
advisor	(optional) entity id of advisor

Details

Note that some major and minor codes start with numbers and include letters (for example: a minor in mathematics is coded as 25I071U). This causes errors when parsing. To get around the issue, either use quotation marks explicitly (as in: minored_in("25I071U")) or use the synonym (minored_in(mathematics))

When using the daterange (from and/or to), the dates will be based on the GRAD DATE for degreeholders and the STOP DATE for attendees (who have no GRAD DATE). Both dates are visible in the Degrees screen in Advance. An alum's "class year" is based on the GRAD DATE. For degreeholders, the two dates are often the same, though they can differ. See examples below. Date options are ignored when looking for current students

Value

A definition of type entity_id

See Also

has_reunion_year

Examples

## majored in philosophy and/or math between 2001 and 2004
## since attendees are not included by default, this only pulls
## (undergrad and grad) degreeholders. Those with a GRAD DATE in the
## daterange will be included
majored_in(mathematics, philosophy, from = 20010101, to = 20041231)

## just math grad degree holders
majored_in(mathematics, undergraduates = FALSE)

## here we pull graduate degreeholders and graduate attendees
## neither ungrad degreeholders nor undergrad attendees will be included
majored_in(mathematics,
           undergraduates = FALSE,
           graduates = TRUE,
           attendees = TRUE)

## evening/wknd program (haas) people are coded as attendees. note that since
## we're only looking at attendees here, we'll be using the STOP DATE
## this will pull BOTH undergrad and grad attendees, but no degreeholders
has_degree_from(haas, attendees = TRUE, degreeholders = FALSE
                from = 20010101, to = 20041231)

## current MBA students
has_degree(MBA, current_students = TRUE, degreeholders = FALSE)

tarakc02/discoveryengine documentation built on Sept. 26, 2023, 12:17 a.m.