Skip to content

Latest commit

 

History

History
76 lines (49 loc) · 4.59 KB

table_setting.md

File metadata and controls

76 lines (49 loc) · 4.59 KB
Raw

TableSetting

from tdw.proc_gen.arrangements.table_setting import TableSetting

A table setting includes a plate, fork, knife, spoon, and sometimes a cup.

  • This is a subclass of Plate. The plate model is always the same; see TableSetting.PLATE_MODEL_NAME.
  • The fork, knife, and spoon models are random; see TableSetting.MODEL_CATEGORIES["fork"], TableSetting.MODEL_CATEGORIES["knife"], and TableSetting.MODEL_CATEGORIES["spoon"].
    • The rotations of the fork, knife, and spoon are perturbed randomly; see TableSetting.CUTLERY_ROTATION_PERTURBATION.
    • The positions of the fork, knife, and spoon are perturbed randomly; see TableSetting.CUTLERY_POSITION_PERTURBATION.
  • Sometimes, there is a CupAndCoaster; see TableSetting.PROBABILITY_CUP_AND_COASTER.
    • The position of the CupAndCoaster is perturbed randomly; see TableSetting.CUP_AND_COASTER_POSITION_PERTURBATION.

Fields

  • root_object_id The ID of the root object.

  • object_ids A list of all of the object IDs in this arrangement.

  • object_ids A list of all of the object IDs in this arrangement.

  • root_object_id The ID of the root object.

  • object_ids A list of all of the object IDs in this arrangement.

  • object_ids A list of all of the object IDs in this arrangement.

Class Variables

Variable Type Description Value
CUP_AND_COASTER_POSITION_PERTURBATION float Randomly perturb the (x, z) positional coordinates of CupAndCoaster by up to +/- this distance. 0.02
CUTLERY_POSITION_PERTURBATION float Randomly perturb the (x, z) positional coordinates of the fork, knife and spoon by up to +/- this distance. 0.03
CUTLERY_ROTATION_PERTURBATION float Randomly perturb the rotation of the fork, knife, and spoon by +/- this many degrees. 3
DEFAULT_CELL_SIZE float The default span used for arranging objects next to each other. 0.6096
ENCLOSED_BY Dict[str, List[str]] A dictionary of categories that can be enclosed by other categories. Key = A category. Value = A list of categories of models that can enclosed by the key category. loads(Path(resource_filename(__name__, "data/enclosed_by.json")).read_text())
FOOD_CATEGORIES List[str] The categories of possible food models. ["apple", "banana", "chocolate", "orange", "sandwich"]
FOOD_PROBABILITY float The probability from 0 to 1 of adding a food model on top of the plate. 0.8
INSIDE_OF Dict[str, List[str]] A dictionary of categories that can be inside of other categories. Key = A category. Value = A list of categories of models that can inside of the key category. loads(Path(resource_filename(__name__, "data/inside_of.json")).read_text())
MODEL_CATEGORIES Dict[str, List[str]] A dictionary of all of the models that may be used for procedural generation. Key = The category. Value = A list of model names. Note that this category overlaps with, but is not the same as, model_record.wcategory; see: Arrangement.get_categories_and_wcategories(). loads(Path(resource_filename(__name__, "data/models.json")).read_text())
ON_TOP_OF Dict[str, List[str]] A dictionary of categories that can be on top of other categories. Key = A category. Value = A list of categories of models that can be on top of the key category. loads(Path(resource_filename(__name__, "data/on_top_of.json")).read_text())
PLATE_MODEL_NAME str The model name of the plate. "plate06"
PROBABILITY_CUP_AND_COASTER float The probability from 0 to 1 of adding a CupAndCoaster. 0.66

Functions

__init__

TableSetting(position)

TableSetting(position, rng=None)

Parameter Type Default Description
position Dict[str, float] The position of the root object. This might be adjusted.
rng Union[int, np.random.RandomState] None Either a random seed or an numpy.random.RandomState object. If None, a new random number generator is created.

get_categories_and_wcategories

Arrangement.get_categories_and_wcategories()

(Static)

Returns: A dictionary of the categories of every model that can be used by Arrangement and their corresponding wcategory and wnid. Key = The model name. Value = A dictionary with the following keys: "category" (the ProcGenObjects category), "wcategory" (the value of record.wcategory), and "wnid" (the value of record.wnid).

get_commands

self.get_commands()

Returns: A list of commands that will generate the arrangement.