---
title: "getEclipseAssociatedSubjects"
canonical: "https://help.vicon.com/space/ShogunPost121/1253737055/getEclipseAssociatedSubjects"
format: markdown
---
# Description

Returns the array of subjects and names from the active trial from Eclipse database. If no selection is made, or the selection doesn't include a trial, the empty array is returned.

## Functional area

Data management

# Command syntax

## Syntax

> Macro (scroll-tablelayout)

|  |
| --- |
| `getEclipseAssociatedSubjects` |

### Arguments

None

### Flags

None

## Return value

string array

The array of string includes the subject; names of active trial from Eclipse database

## Examples

```plaintext
// Print all subjects for active trial from Eclipse database
string $subjects[] = `getEclipseAssociatedSubjects`;
int $l = `getCount $subjects`;
print ("Subjects count = " + string($l), $subjects);
```

> Macro (scroll-pagebreak)

# Additional information

## Related commands

- [getEclipseActiveTrial](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253736573)
- [getEclipseAssociatedCalibration](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737516)
- [getEclipseMarkedTrials](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737009)