Cook digital.
grill
namespace, meta-package with core tools and philosophy guidelines.
With future users and readers in mind, the grill
aims to stick to the following principles:
- DRY (don't repeat yourself)
- SSOT (single source of truth)
- Convention over configuration (sensible defaults)
- SOLID (understandable, flexible and maintainable)
- KISS (keep it simple)
Foundational tools:
python -m pip install grill
The following optional dependencies should be installed separately.
- graphviz (for graph widgets)
- usdview (hopefully will be available soon via pypi). In the meantime, it can be downloaded from NVidia or built from USD source (conda recipe)
For environment management, the grill
uses conda
.
This is a walk-through on how to start using the grill
tools with a fresh conda
environment.
-
If
conda
is not on the system yet, install miniconda.Note:
conda
environment manager comes in two flavours: -
Launch Anaconda Prompt (it came as part of the
miniconda
installation) -
Create a new
conda
environment withpython=3.7
, e.g:(base) C:\>conda create -n grilldemo01 python=3.7
-
Activate that environment
(base) C:\>conda activate grilldemo01
-
Install
grill
via pip(grilldemo01) C:\>python -m pip install grill
-
If missing, optionally install
graphviz
via conda(grilldemo01) C:\>conda install -c anaconda graphviz
-
If missing, optionally install
usdview
via NVidia builds or via building USD from source using this conda recipe.Note that if you're installing via the NVidia builds, you'll need
PyOpenGL
as well:(grilldemo01) C:\>python -m pip install PyOpenGL
-
Extend the
PXR_PLUGINPATH_NAME
environment variable to include theplugInfo.json
file from thegrill.resources
path location.To know where the installed file is, run the following python command:
(grilldemo01) C:\Users\Christian>python -c "from pathlib import Path;from grill import resources;path=(Path(resources.__path__._path[0]) / 'plugInfo.json');assert path.is_file();print(path)"
It will print something like:
C:\Users\Christian\.conda\envs\grilldemo01\lib\site-packages\grill\resources\plugInfo.json
Which you can use to extend the pixar environment variable, e.g:
(grilldemo01) C:\Users\Christian>set PXR_PLUGINPATH_NAME=%PXR_PLUGINPATH_NAME%;C:\Users\Christian\.conda\envs\grilldemo01\lib\site-packages\grill\resources\plugInfo.json
-
You should be able to launch
usdview
and see theGrill
menu on the menu bar.(grilldemo01) C:\Users\Christian>usdview B:\read\cg\downloads\Kitchen_set\Kitchen_set\Kitchen_set.usd