GO::Mo...ionship(3pm)

💖 GO::Model::Relationship 💖

okay so bestie, welcome to the manpage for GO::Model::Relationship, which lives in the User Contributed Perl Documentation section (that's the (3pm) part, iykyk). it's a whole module about the relationship between two terms. that's the vibe. that's the assignment. periodt.

---

✨ NAME ✨

GO::Model::Relationship — relationship between two terms 🦋

---

✨ SYNOPSIS ✨

okay so… there's literally nothing here. the SYNOPSIS is empty. it's giving "I have nothing to say" energy and honestly? relatable. moving on 💅

---

✨ DESCRIPTION ✨

so a Relationship is, like, a relationship between two GO::Model::Terms. two terms. vibing. connected. 🌸

think of relationships as statements or sentences that look like this:

  SUBJECT-TERM PREDICATE OBJECT-TERM

for example:

  "dog" IS_A "animal"

  "G-Protein coupled receptor" IS_A "transmembrane receptor"

every statement has three parts, bestie:

• a subject — the subject of the sentence/statement
• a predicate / relationship-type — the thing linking them
• an object — the object of the sentence/statement

Relationships can also be seen as arcs in a directed graph 📈, where the subject is equivalent to the child, and the object is equivalent to the parent. the arc gets labeled with the predicate/relationship-type. iconic behaviour honestly.

🚨 important tea: a Relationship object currently does not contain an actual pointer to a GO::Model::Term object. instead it stores the ID of that term. this is intended to be used in conjunction with the Graph object, or with the database. so don't go looking for the Term in here, she's not here 💀

---

🎀 subject_acc 🎀

• Title: subject_acc
• Usage: $obj->subject_acc($newid)
• Usage: $currid = $obj->subject_acc()
• Synonyms: subj_acc, acc2, child_acc
• Function: gets or sets the identifier for the child/subject term
• Example:
• Returns: value of subject_acc (string)
• Args: on set, new value (string)

(yeah the Example line is empty in the original too, not me being lazy, I promise 🙈)

so all Relationships are basically "subject-predicate-object" statements. the statement is about the subject, and it states something about the relationship to the object. queen of grammar fr fr 👑

for example, if we have a Relationship:

         cell
           ^
           |
           | [part_of]
           |
        cell nucleus

this is a statement about cell nuclei in general, so "cell nucleus" is the subject (sometimes called the child node). the Relationship tells us that all cell nuclei are part_of some cell, so the object of the relationship (sometimes called the parent node) is "cell". see how it all connects?? the way that science ate that up 💅

---

🎀 object_acc 🎀

• Title: object_acc
• Usage: $obj->object_acc($newid)
• Usage: $currid = $obj->object_acc()
• Synonyms: obj_acc, acc1, parent_acc
• Function: gets or sets the identifier for the parent/object term
• Example:
• Returns: value of object_acc (string)
• Args: on set, new value (string)
• See Also: subj_acc

---

🎀 type 🎀

• Title: type
• Usage: $obj->type($newval)
• Usage: $currval = $obj->type()
• Synonyms: (none, she's unbothered)
• Function: gets or sets the relationship type (a string)
• Example:
• Returns: value of type (string)
• Args: on set, new value (string)

🔮 right now, literally any string is allowed. but in future the type string may be constrained to come from a controlled vocabulary of relationship types. so enjoy the freedom while it lasts, bestie 😭

---

and that's the whole page!! 💜 slay ✨

this was brought to you by perl v5.36.0, dated 2023-12-18 — read the docs, hydrate, and go be the main character of your own directed graph 🦋💖🎀