Quickstart: Generate your first datapoint#
The code sample below generates a data request that you can submit to our platform to get a visual datapoint of a synthetic human.
Step 1: Create your data request#
This page contains an interactive Python kernel that installs our PyPi package on pageload.
!pip install datagen-tech -q
Click Run in the code block below to generate a download request.
from datagen import api
from datagen.api import assets, catalog
from datagen.api.catalog import attributes
from datagen.api.catalog.attributes import Gender, Ethnicity, Age
import random
# choose an actor
human = random.choice(catalog.humans.get(limit=300))
# define the background & camera
background = random.choice(catalog.backgrounds.get())
default_camera = assets.Camera()
datapoint_requests = [api.create_datapoint(human=human, camera=default_camera, background=background)]
# define the datapoint and create a json file
api.dump(assets.DataRequest(datapoints=datapoint_requests), path="data_request.json")
Next, click Run below to generate a link to the JSON file you created.
from IPython.display import HTML
import os, base64
def make_download_link(filepath):
filename = os.path.basename(filepath)
with open(filepath, "rb") as f:
data = base64.b64encode(f.read()).decode()
return HTML(f'<h3><a href="data:application/binary;base64,{data}" download={filename}>Click here</a> to download {filename}.</h3>')
filepath = "data_request.json"
make_download_link(filepath)
Install our PyPi package in your Python environment (requires version 3.6 or higher):
pip install datagen-tech
Then run this code to create your data request:
import datagen.api as api
from datagen.api import assets, catalog
from datagen.api.catalog import attributes
from datagen.api.catalog.attributes import Gender, Ethnicity, Age
import random
# choose an actor
human = random.choice(catalog.humans.get(limit=200))
# define the background & camera
background = random.choice(catalog.backgrounds.get())
default_camera = assets.Camera()
datapoint_requests = [api.create_datapoint(human=human, camera=default_camera, background=background)]
# define the datapoint and create a json file
api.dump(assets.DataRequest(datapoints=datapoint_requests), path="data_request.json")
Your data request will be created as a file called data_request.json.
Step 2: Generate your data#
Log in or Sign up for freeSee Generating your data for instructions on how to upload your data request. We will start generating your datapoint immediately.

An example of a randomly generated datapoint.#