The datagen.api.catalog.humans.count() function tells you how many human assets match your query. You can count how many humans there are in total, or filter the catalog using human attributes.
When you get a human object from the catalog, you can edit that human object in certain ways. These are the editable properties of human objects:
id
string
The UUID of the actor in the scene.
This property selects one of Datagen’s thousands of available identities to be the actor at the (metaphorical) center of your scene. The value of this property defines the skin tone, skin textures, and body shape of the generated human subject. It also includes default values for the hair, eyes, eyebrows, and other aspects of human identity that can be easily altered.
Tip
To download a CSV with a complete list of available identities, click here
The actors in our catalogue are grouped…
By gender
Females
To download a CSV with a complete list of available female identities, click here
Males
To download a CSV with a complete list of available male identities, click here
By age group
Younger (ages 18-30)
To download a CSV with a complete list of available identities ages 18-30, click here
Adult (ages 31-50)
To download a CSV with a complete list of available identities ages 31-50, click here
Older (ages 51+)
To download a CSV with a complete list of available identities ages 51+, click here
By ethnicity
Africans
To download a CSV with a complete list of available African identities, click here
Hispanics
To download a CSV with a complete list of available Hispanic identities, click here
Mediterraneans
To download a CSV with a complete list of available Mediterranean identities, click here
North Europeans
To download a CSV with a complete list of available North European identities, click here
South Asians
To download a CSV with a complete list of available South Asian identities, click here
Southeast Asians
To download a CSV with a complete list of available Southeast Asian identities, click here
head
The head object defines aspects of the human’s appearance that relate to the head. It contains the following objects:
eyes
An eyes asset from the asset catalog. Each human identity comes with default eyes, which you can edit or replace.
This code takes a human from the catalog and changes the default eyes:
A facial_hair asset from the asset catalog. Each human identity comes with default facial hair (in many cases this default is “none”). You can add, remove, or change this default.
This code takes a human from the catalog and changes the default facial hair:
Location is defined using x, y, and z global coordinates, measured in meters. Each value is a floating-point variable that can range from -5 to 5 meters.
Important
The location of the actor is the most critical setting in your data request. If the actor is in the wrong place, they might not be in the camera frame and you will render nothing but the background.
For an in-depth look at these axes, as well as which part of the head is actually placed at the coordinates you set, see About our coordinate systems.
rotation
The rotation object defines how the actor’s head will be rotated about the neck, while the neck remains upright. When we generate your datapoint, the coordinates of the neck are set first using the location setting; afterwards, we rotate the head about the neck using pitch, yaw, and roll settings that you define here.
The pitch, yaw, and roll properties are floating-point values measured in degrees. Pitch can range from -90 to 90, while yaw and roll can range from -45 to 45.
Tip
Use this visualization tool to experiment with rotating the actor’s head in the scene. Note that the visualizer rotates the head and neck together; when you create your datapoints, the neck will be held still while the head is tilted around it in a realistic fashion.
This code takes a human from the catalog and changes the default head rotation:
The expression object defines the type and the intensity of your actor’s facial expression. The expression type is defined using an Enum, while the intensity is a float that ranges from 0 (neutral expression) to 1 (maximum intensity).
