Examples#

Command Line Interface#

usage: python -m infinigen_examples.generate_nature [-h]
                                                    [--output_folder OUTPUT_FOLDER]
                                                    [--input_folder INPUT_FOLDER]
                                                    [-s SEED]
                                                    [-t {coarse,populate,fine_terrain,ground_truth,render,mesh_save,export} [{coarse,populate,fine_terrain,ground_truth,render,mesh_save,export} ...]]
                                                    [-g CONFIGS [CONFIGS ...]]
                                                    [-p OVERRIDES [OVERRIDES ...]]
                                                    [--task_uniqname TASK_UNIQNAME]
                                                    [-d [DEBUG ...]]

Named Arguments#

--output_folder
--input_folder
-s, --seed

The seed used to generate the scene

-t, --task

Possible choices: coarse, populate, fine_terrain, ground_truth, render, mesh_save, export

Default: ['coarse']

-g, --configs

Set of config files for gin (separated by spaces) e.g. --gin_config file1 file2 (exclude .gin from path)

Default: ['base']

-p, --overrides

Parameter settings that override config defaults e.g. --gin_param module_1.a=2 module_2.b=3

Default: []

--task_uniqname
-d, --debug
usage: python -m infinigen_examples.generate_indoors [-h]
                                                     [--output_folder OUTPUT_FOLDER]
                                                     [--input_folder INPUT_FOLDER]
                                                     [-s SEED]
                                                     [-t {coarse,populate,fine_terrain,ground_truth,render,mesh_save,export} [{coarse,populate,fine_terrain,ground_truth,render,mesh_save,export} ...]]
                                                     [-g CONFIGS [CONFIGS ...]]
                                                     [-p OVERRIDES [OVERRIDES ...]]
                                                     [--task_uniqname TASK_UNIQNAME]
                                                     [-d [DEBUG ...]]

Named Arguments#

--output_folder
--input_folder
-s, --seed

The seed used to generate the scene

-t, --task

Possible choices: coarse, populate, fine_terrain, ground_truth, render, mesh_save, export

Default: ['coarse']

-g, --configs

Set of config files for gin (separated by spaces) e.g. --gin_config file1 file2 (exclude .gin from path)

Default: ['base']

-p, --overrides

Parameter settings that override config defaults e.g. --gin_param module_1.a=2 module_2.b=3

Default: []

--task_uniqname
-d, --debug
usage: python -m infinigen_examples.generate_individual_assets
       [-h] [-o OUTPUT_FOLDER] [-f FACTORIES [FACTORIES ...]] [-n N_IMAGES]
       [-m MARGIN] [-R RESOLUTION] [-p SAMPLES] [-l LIGHTING] [-Z CAM_ZOFF]
       [-s] [-e ELEVATION] [--cam_dist CAM_DIST]
       [-a CAM_ANGLE [CAM_ANGLE ...]] [-O OFFSET [OFFSET ...]] [-c CAM_CENTER]
       [-r {image,video,none}] [-b BEST_RATIO] [-F] [-I FIRE_RES]
       [-U FIRE_DURATION] [-t FILM_TRANSPARENT] [-E FRAME_END] [-g]
       [-C CYCLES] [-A] [-S] [-P] [-D SEED] [-N] [-H] [-T] [-G] [-B] [-W] [-z]
       [--n_workers N_WORKERS] [--slurm]
       [--export {fbx,obj,usdc,usda,stl,ply}]
       [--export_texture_res EXPORT_TEXTURE_RES] [-d [DEBUG ...]] [--dryrun]
       [--configs CONFIGS [CONFIGS ...]]
       [--overrides OVERRIDES [OVERRIDES ...]]

Named Arguments#

-o, --output_folder
-f, --factories

List factories/surface scatters/surface materials you want to render

Default: []

-n, --n_images

Number of scenes to render

Default: 1

-m, --margin

Margin between the asset the boundary of the image when automatically adjusting the camera

Default: 0.01

-R, --resolution

Image resolution widthxheight

Default: '1024x1024'

-p, --samples

Blender cycles samples

Default: 200

-l, --lighting

Lighting seed

Default: 0

-Z, --cam_zoff, --z_offset

Additional offset on Z axis for camera look-at positions

Default: 0.0

-s, --save_blend

Whether to save .blend file

Default: False

-e, --elevation

Elevation of the sun

Default: 60

--cam_dist

Distance from the camera to the look-at position

Default: 0

-a, --cam_angle

Camera rotation in XYZ

Default: (-30, 0, 45)

-O, --offset

asset location

Default: (0, 0, 0)

-c, --cam_center

Camera rotation in XYZ

Default: 1

-r, --render

Possible choices: image, video, none

Whether to render the scene in images or video

Default: 'image'

-b, --best_ratio

Best aspect ratio for compiling the images into asset grid

Default: 0.5625

-F, --fire

Default: False

-I, --fire_res

Default: 100

-U, --fire_duration

Default: 30

-t, --film_transparent

Whether the background is transparent

Default: 1

-E, --frame_end

End of frame in videos

Default: 120

-g, --gpu

Whether to use gpu in rendering

Default: False

-C, --cycles

render video cycles

Default: 1

-A, --scale_reference

Add the scale reference

Default: False

-S, --skip_existing

Skip existing scenes and renders

Default: False

-P, --postprocessing_only

Only run postprocessing

Default: False

-D, --seed

Run a specific seed.

Default: -1

-N, --no-mod

No modification

Default: False

-H, --hdri

add_hdri

Default: False

-T, --three_point

add three-point lighting

Default: False

-G, --no_ground

no ground

Default: False

-B, --white_background

white background

Default: False

-W, --spawn_placeholder

spawn placeholder

Default: False

-z, --zoom

zoom first figure

Default: False

--n_workers

Default: 1

--slurm

Default: False

--export

Possible choices: fbx, obj, usdc, usda, stl, ply

--export_texture_res

Default: 1024

-d, --debug
--dryrun

Import assets but do not run them. Used for testing.

Default: False

--configs

List of gin config files to apply

Default: []

--overrides

List of gin overrides to apply

Default: []

asset_parameters#

generate_asset_demo#

infinigen_examples.generate_asset_demo.compose_scene(...)[source]#
Parameters:
  • output_folder (Path)

  • scene_seed (int)

  • asset_factory -- (default: None)

  • grid_rad -- (default: 1.2)

  • grid_dim -- (default: 3)

  • background -- (default: 'grass')

  • camera_circle_radius -- (default: 8)

  • camera_altitude -- (default: 2)

  • circle_duration_sec -- (default: 25)

  • fstop -- (default: 2)

  • asset_scale -- (default: (1, 1, 1))

  • asset_offset -- (default: (0, 0, 0))

generate_asset_parameters#

generate_individual_assets#

generate_indoors#

infinigen_examples.generate_indoors.compose_indoors(output_folder, scene_seed, **overrides)[source]#
Parameters:
  • output_folder (Path)

  • scene_seed (int)

generate_material_balls#

generate_nature#

infinigen_examples.generate_nature.compose_nature(output_folder, scene_seed, **params)[source]#
Parameters:
  • output_folder

  • scene_seed

infinigen_examples.generate_nature.populate_scene(...)[source]#
Parameters:
  • output_folder (Path)

  • scene_seed (int)

  • camera_rigs (list[Object])

Module contents#