Sociogram

java.lang.Object
- sociogram.Sociogram

```
public class Sociogram
extends java.lang.Object
```
It represents a graph with a matrix with the relations among individuals.

Author:

Iván García-Magariño

Field Summary

Fields
Modifier and Type	Field and Description
`private IndividualAgent[]`	`agents` Vector of agents
`private static int`	`COLUMN_HEADER_LENGTH` Number of characters that is used for representing the column header
`static int`	`COLUMN_LENGTH` Number of characters that is used for representing each column
`private static double`	`CST_INC` Incremental Value each time an agent makes a social connection.
`private double[][]`	`matrix` Adyacency matrix with their relationship with values in the interval [-1,+1], where negative values expresses rejection and positive values represents selection
`static java.text.DecimalFormat`	`METRIC_FORMAT` Format of the double values printed in the text file for representing the sociogrametric values, and it is also used from the GUI.
`private static double`	`REJECTION_THRESHOLD` Relationship Value from which it is considered to be a rejection.
`private static java.text.DecimalFormat`	`RELATION_FORMAT` Format of the double values printed in the text file for representing the sociogram relations.
`private static double`	`SELECTION_THRESHOLD` Relationship Value from which it is considered to be a selection.
`private int`	`size` Number of Individuals
`private double[][]`	`trend` Trend matrix that represents the trend of each relatinship with values in the interval [-1,+1], where negative values expresses decrease of the reletaionship, and positive represents the increase of the relationship,

Constructor Summary

Constructors
Constructor and Description

Sociogram(java.util.List<IndividualAgent> list)
Constructor of the Class.

Constructors
Constructor and Description
`Sociogram(java.util.List<IndividualAgent> list)` Constructor of the Class.

Method Summary

Methods
Modifier and Type	Method and Description
`IndividualAgent[]`	`getAgents()`
`double[][]`	`getMatrix()`
`int`	`getSize()`
`double`	`getTrend(IndividualAgent agentA, IndividualAgent agentB)` Sets the the trend in a pair of agents
`double`	`measureIAg()`
`double`	`measureICg()` Measure the Coherence of the group with the sociometric ICg described in (Barrasa & Gil, 2008).
`double`	`measureIDg()` Measure the Dissociation of the group with the sociometric IDg described in (Barrasa & Gil, 2008).
`double`	`measureIIg()` Measure the Intensity of the Group with the sociometric IIg described in (Barrasa & Gil, 2008).
`int`	`measureRe(int indexAgent)` Measure the Reciprocity of Selections: number of selections of an agent that have been selected back with reciprocal selections.
`int`	`measureRr(int indexAgent)` Measure the Reciprocity of Rejections: number of rejections of an agent that have been rejected back with reciprocal rejections.
`int`	`measureSe(int indexAgent)` Measure the selections receibed by subject.
`int`	`measureSr(int indexAgent)` Measure the rejections receibed by the subject.
`void`	`save(java.io.PrintStream out)` Saves the sociogram in a text field determined by the stream of the parameter.
`void`	`setTrend(IndividualAgent agentA, IndividualAgent agentB, double trend)` Sets the the trend in a pair of agents
`void`	`updateConnection(IndividualAgent agentA, IndividualAgent agentB, double trend)` Update a social connection in the sociogram based on a trend

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - size
```
private int size
```
    Number of Individuals
  - matrix
```
private double[][] matrix
```
    Adyacency matrix with their relationship with values in the interval [-1,+1], where negative values expresses rejection and positive values represents selection
  - trend
```
private double[][] trend
```
    Trend matrix that represents the trend of each relatinship with values in the interval [-1,+1], where negative values expresses decrease of the reletaionship, and positive represents the increase of the relationship,
  - agents
```
private IndividualAgent[] agents
```
    Vector of agents
  - CST_INC
```
private static double CST_INC
```
    Incremental Value each time an agent makes a social connection. It representes the percentate (in a number from zero to one) of the distance to the limit that is increased.
  - RELATION_FORMAT
```
private static java.text.DecimalFormat RELATION_FORMAT
```
    Format of the double values printed in the text file for representing the sociogram relations.
  - METRIC_FORMAT
```
public static java.text.DecimalFormat METRIC_FORMAT
```
    Format of the double values printed in the text file for representing the sociogrametric values, and it is also used from the GUI.
  - COLUMN_HEADER_LENGTH
```
private static int COLUMN_HEADER_LENGTH
```
    Number of characters that is used for representing the column header
  - COLUMN_LENGTH
```
public static int COLUMN_LENGTH
```
    Number of characters that is used for representing each column
  - SELECTION_THRESHOLD
```
private static double SELECTION_THRESHOLD
```
    Relationship Value from which it is considered to be a selection. This value must be within the [0, 1] interval.
  - REJECTION_THRESHOLD
```
private static double REJECTION_THRESHOLD
```
    Relationship Value from which it is considered to be a rejection. This value must be within the [-1, 0] interval.
- Constructor Detail
  - Sociogram
```
public Sociogram(java.util.List<IndividualAgent> list)
```
    Constructor of the Class. It creates an adjacency matrix from a list of agents, relating them with a default value of zero.
    
    Parameters:
    list - The list of agents for building the sociogram.
- Method Detail
  - updateConnection
```
public void updateConnection(IndividualAgent agentA,
                    IndividualAgent agentB,
                    double trend)
```
    Update a social connection in the sociogram based on a trend
    
    Parameters:
    agentA - the first agent of the relation
    agentB - the second agent of the relation
    trend - the trend of the relation in the interval [-1,1]
  - setTrend
```
public void setTrend(IndividualAgent agentA,
            IndividualAgent agentB,
            double trend)
```
    Sets the the trend in a pair of agents
    
    Parameters:
    agentA - the first agent of the relation
    agentB - the second agent of the relation
    trend - the trend of the relation in the interval [-1,1]
  - getTrend
```
public double getTrend(IndividualAgent agentA,
              IndividualAgent agentB)
```
    Sets the the trend in a pair of agents
    
    Parameters:
    agentA - the first agent of the relation
    agentB - the second agent of the relation
  - save
```
public void save(java.io.PrintStream out)
```
    Saves the sociogram in a text field determined by the stream of the parameter.
    
    Parameters:
    out - the stream where the sociagram content is printed
  - measureIAg
```
public double measureIAg()
```
  - measureIDg
```
public double measureIDg()
```
    Measure the Dissociation of the group with the sociometric IDg described in (Barrasa & Gil, 2008).
  - measureICg
```
public double measureICg()
```
    Measure the Coherence of the group with the sociometric ICg described in (Barrasa & Gil, 2008). For practical purposes, it returns zero when there ist not any selction in the sociogram.
  - measureIIg
```
public double measureIIg()
```
    Measure the Intensity of the Group with the sociometric IIg described in (Barrasa & Gil, 2008).
  - measureRe
```
public int measureRe(int indexAgent)
```
    Measure the Reciprocity of Selections: number of selections of an agent that have been selected back with reciprocal selections.
    
    Parameters:
    indexAgent - the index of the agent that is measured
    
    Returns:
    the value of the sociometric
  - measureRr
```
public int measureRr(int indexAgent)
```
    Measure the Reciprocity of Rejections: number of rejections of an agent that have been rejected back with reciprocal rejections.
    
    Parameters:
    indexAgent - the index of the agent that is measured
    
    Returns:
    the value of the sociometric
  - measureSe
```
public int measureSe(int indexAgent)
```
    Measure the selections receibed by subject.
    
    Parameters:
    indexAgent - the index of the agent that is measured
    
    Returns:
    the value of the sociometric
  - measureSr
```
public int measureSr(int indexAgent)
```
    Measure the rejections receibed by the subject.
    
    Parameters:
    indexAgent - the index of the agent that is measured
    
    Returns:
    the value of the sociometric
  - getSize
```
public int getSize()
```
  - getAgents
```
public IndividualAgent[] getAgents()
```
  - getMatrix
```
public double[][] getMatrix()
```

Class Sociogram

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

size

matrix

trend

agents

CST_INC

RELATION_FORMAT

METRIC_FORMAT

COLUMN_HEADER_LENGTH

COLUMN_LENGTH

SELECTION_THRESHOLD

REJECTION_THRESHOLD

Constructor Detail

Sociogram

Method Detail

updateConnection

setTrend

getTrend

save

measureIAg

measureIDg

measureICg

measureIIg

measureRe

measureRr

measureSe

measureSr

getSize

getAgents

getMatrix