Name

add_social_partners — Ensure that all social interaction partners are in the group composition data

Synopsis

INT add_social_partners ( chimpid,  
  rgid);  
VARCHAR(5) chimpid ;
BIGINT rgid ;
 

Input

chimpid

A CHIMPIDS.ChimpID value of a chimp in a group composition who may have social partners.

rgid

A RAW_GROUPS.RGID value identifying the group composition.

Description

add_social_partners adds all non-UNK social partners, and the mother's of young infant social partners and the young infants of mother social partners, of the specified chimp to the group composition data identified by the rgid. Social partners are those individuals (or baboons[64]) which interact with the given individual in any way during the time period starting with the time of the group composition (inclusive of endpoint) and ending with the time of the follow's next group composition (exclusive of endpoint). The group composition is unchanged if all social partners are already in the group composition.

add_social_partners() calls mom_in_gc() and infants_in_gc() on the added social partners to ensure that young infants are in the group composition with their mothers and vice versa.

Caution

This function does not check it's arguments. It assumes that the supplied chimpid is in the supplied group composition.

When inserting a RAW_GROUPMEMBERS row the ChimpID value used is the BIOGRAPHY_DATA.AnimID of a social partner [65], the Origin value used is always A, and the Uncertain value always FALSE

This function always returns 0.



[64] While baboons are not individually identified anywhere the RAW_GROUPS table does have a flag indicating whether baboons are present.

[65] This matters in the case of twins.


Page generated: 2018-08-25T22:19:28-04:00.