Genogram data in detail

In this section we look at the data in more detail.

People appear pretty much everywhere in a genogram. The person in context, parents, grandparents, siblings and children are all defined by the PERSON data structure. It is a key data building block and therefore a very good place to start.

PERSON

 

ID
The ID is a unique and mandatory character string that represents the person and is very important to the operation of an interactive genogram. Whenever someone clicks a person symbol the ID is passed to the supplied callback function so that the genogram can be redrawn with that person in context. Click here for more details on setting up interactivity.

name
The name of the person. Mandatory.

dob
The person's date of birth. Must be YYYY-MM-DD format. Optional.

gender
The person's gender. Possible values: male, female, transgenderMaleToFemale, transgenderFemaleToMale, nonbinary. Mandatory.

alive
Whether this person is still alive. Possible values: Y or N. Optional.

dod
The person's date of death. Must be YYYY-MM-DD format. Optional.

parentalStatus
The relationship of this person to their parents. Possible values: naturalBirth, adopted or fostered. Optional.

attributes
A list of name/value pairs containing additional information about the person. Possible values: user-defined. Values can include HTML, which will be rendered when the pop-up containing this data appears. This makes it possible to include photos, videos and external documents as information, as well as normal text. Have a look at an example here.

PERSON IN CONTEXT

 

The Person In Context is the person at the centre of the genogram, that all of the data relates to. It is mandatory and simply defined as a PERSON. You can see an example here.

PARENTS

The mother and father of the person in context are defined using the standard PERSON data structure.

 

parents
The person in context's parents. Optional. If no data is supplied the genogram will create dummy data to represent the parents.

father
The person in context's father. Optional. If no data is supplied the genogram will create dummy data.

mother
The person in context's mother. Optional. If no data is supplied the genogram will create dummy data.

relationship
The nature of the parent's relationship. Optional. Possible values: enduring, married, engaged, separated, legallySeparated, separationInFact, widowed.

relationshipFrom
When the parents relationship started. Must be YYYY-MM-DD format. Optional.

relationshipTo
When the parents relationship ended. Must be YYYY-MM-DD format. Optional.

You can see an example here.

GRANDPARENTS

Grandparent data is held separately for the person in context's father and mother, i.e.

 

and

 

paternalGrandparents
Grandparents on the person in context's father's side. Optional. If no data is supplied the genogram will create dummy data to represent the paternal grandparents.

maternalGrandparents
Grandparents on the person in context's mother's side. Optional. If no data is supplied the genogram will create dummy data to represent the maternal grandparents.

relationship
The nature of the parent's relationship. Possible values: enduring, married, engaged, separated, legalSeparation, separationInFact, widowed. Optional.

relationshipFrom
When the parents relationship started. Must be YYYY-MM-DD format. Optional.

relationshipTo
When the parents relationship ended. Must be YYYY-MM-DD format. Optional.

You can see an example here.

SIBLINGS and HALF-SIBLINGS

Siblings and half-siblings are represented as an array of PERSONs, i.e.

 
 
 

siblings
An array of the person in context's siblings. Optional.

fatherHalfsiblings
An array of the person in context's half-siblings on their father's side. Optional.

motherHalfsiblings
An array of the person in context's half-siblings on their mother's side. Optional.

You can see an example here.

PARTNERS and CHILDREN

Partners are people that the person in context has, or has had, a significant relationship with. The person in context may have had children with their partners. In terms of data, partners and children are both represented using the standard PERSON structure. If there are children they are held as a PERSON array for each partner, i.e.

 

partners
An array of partners. Optional.

children
An array of children associated with a particular partner. Optional.

You can see an example here.

OTHER RELATIONSHIPS

Other relationships are used to show significant connections outside of the person in context's immediate family. Four types of other relationship are supported: people, pets, professionals and institutions.

 

Other relationships are optional but if present, are held in an array. A maximum of 10 other relationships is permitted.

You can see an example here.

SAME HOUSEHOLD

Same household indicates people who live at the same address as the person in context. The data is held as an array of PERSONs:

 

Same household is optional data but if present, the IDs of the people listed in the array must exist elsewhere in the genogram data, i.e. in grandparents, parents, siblings, etc.

You can see an example here.

MULTIPLE BIRTHS

Multiple births are twins, triplets and quadruplets and are held as an array of birth sets:

 

multipleBirths
An array of multiple birth sets. Optional.

set
An array of people who are part of a multiple birth. Two people in the set indicate twins, three people indicate triplets, and so on.

identical
Indicates that the multiple birth set is indentical, e.g. identical twins. Possible values: Y,N. Optional.

You can see an example here.

EMOTIONAL RELATIONSHIPS

Emotional relationships are held as an array containing pairs of people and the emotion that connects them:

 

Emotional relationships are optional data but if present, the IDs of the pairs of people listed in the array must exist elsewhere in the genogram data, i.e. as grandparents, parents, siblings, etc.

person1
The first person in the pair. Mandatory.

person2
The second person in the pair. Mandatory.

emotion
The emotion that connects this pair of people. Mandatory. Possible values:

Emotion code value Description
indifferent indifferent/apathetic
distant distant/poor
cutoff cutoff/estranged
cutoffRepaired cutoff repaired
discord discord/conflict
hate hate
harmony harmony
friendship friendship/close
bestFriends best friends/very close
love love
inLove in love
emotionalConnection emotional connection
hostile hostile
distantHostile distant hostile
closeHostile close hostile
fusedHostile fused hostile
fused fused
distrust distrust
violence violence
distantViolence distant violence
closeViolence close violence
fusedViolence fused violence
focusedOn focused on
focusedOnNegatively focused on negatively
abuse abuse
physicalAbuse physical abuse
emotionalAbuse emotionalAbuse
sexualAbuse sexualAbuse
neglect neglect (abuse)
neverMet never met
manipulative manipulative
controlling controlling
jealous jealous
fan fan/admirer
limerence limerence
normal plain/normal

You can see an example here.

CONFIGURATION PARAMETERS

Configuration parameters are held as a simple list of name/value pairs:

 
Configuration parameter Value Description Default
The following parameters override the default genogram symbol colours.
picColour CSS colour, e.g. orange, #ffa500 or rgb(255 165 0) person in context symbol #00800050
parentColour CSS colour parent symbol #fff10050
grandParentColour CSS colour grandparent symbol #00b29450
halfSiblingColour CSS colour half sibling symbol #e8112350
siblingColour CSS colour sibling symbol #ec008c50
partnerColour CSS colour partner symbol 68217a50
childrenColour CSS colour parent symbol #a7c7e780
otherRelationshipColour CSS colour other relationship symbol #00bcf250
By default, GenoConnect automatically generates symbols for grandparents and parents if no data is provided. The following parameters allow this behaviour to be overridden.
hideGrandparentsAlways Y or N grandparents are not shown in the genogram N
hideGrandparentsWhenNoData Y or N grandparents are not shown if no grandparent data is supplied N

You can see an examples here and here.

HEADER ATTRIBUTES

Header attributes are pieces of information that are displayed in the genogram header.

 
headerAttributes
Name/value pairs to be displayed in the Genogram header. A maximum of 2 pieces of information can be provided. Optional.

name
The name of information to be displayed.

value
The inormation value.

index
The order in which the header attributes should be displayed. Optional.

You can see an example here.