---
name: "GO::Model::Association"
section: "3pm"
platform: "linux"
package: "libgo-perl"
version: "0.15-10"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/GO::Model::Association"
---

# GO::Model::Association(3pm)

## NAME

```
  GO::Model::Association - association between a GO term and a gene product
```

## SYNOPSIS

```
  # print all gene products associated with a GO::Model::Term
  my $assoc_l = $term->association_list;
  foreach my $assoc (@$assoc_l) {
    printf "gene product:%s %s %s (evidence: %s)\n",
      $assoc->gene_product->symbol,
      $assoc->is_not ? "IS NOT" : "IS",
      $term->name,
      map {$_->code} @{$assoc->evidence_list};
  }
```

## DESCRIPTION

Represents an association between a GO term (GO::Model::Term) and a gene product (GO::Model::GeneProduct)

### go\_public\_acc

```
  Usage   -
  Returns -
  Args    -
```

### add\_evidence

```
  Usage   - $assoc->add_evidence($my_evid);
  Returns -
  Args    - GO::Model::Evidence
```

### evidence\_list

```
  Usage   - my $ev_l = $assoc->evidence_list;
  Returns -
  Args    -
```

gets/sets arrayref of GO::Model::Evidence

### evidence\_as\_str

```
  Usage   - print $assoc->evidence_as_str
  Usage   - print $assoc->evidence_as_str(1); #verbose
  Returns -
  Args    - verbose
```

concatenates evcodes together, for display

### has\_evcode

```
  Usage   - if $assoc->has_evcode("IEA");
  Returns - boolean
  Args    - evcode [string]
```

### remove\_evcode

```
  Usage   - $assoc->remove_evcode("IEA");
  Returns -
  Args    - evcode [string]
```

removes all evidence of the specified type from the association; useful for filtering

### evidence\_score

```
  Usage   - my $score = $assoc->evidence_score
  Returns - 0 <= float <= 1
  Args    -
```

returns a score for the association based on the evidence;

This is an EXPERIMENTAL method; it may be removed in future versions.

The evidence fields can be thought of in a loose hierarchy:

TAS\
    IDA\
       IMP/IGI/IPI\
                  ISS\
                     NAS

see http://www.geneontology.org/GO.evidence.html

### gene\_product

```
  Usage   - my $gp = $assoc->gene_product
  Returns -
  Args    -
```

gets sets GO::Model::GeneProduct

### assigned\_by

```
  Usage   -
  Returns -
  Args    -
```

### is\_not

```
  Usage   -
  Returns -
  Args    -
```

gets/sets boolean representing whether this relationship is negated

### assocdate

```
  Usage   -
  Returns -
  Args    -
```

### assocdate

```
  Usage   -
  Returns -
  Args    -
```

gets/sets integer representing the date of the association (YYYYMMDD format)

### role\_group

```
  Usage   -
  Returns -
  Args    -
```

gets/sets integer to indicate which associations go together