Skip to main content

Dynamic Skies and Sun Study

This tutorial shows you how to use Dynamic Skies and Environment Sun Study to accurately position the sun based on the geolocation of your stage in Cesium for Omniverse and to capture sun study images and video. You’ll continue to use the San Francisco project created during previous tutorials.

Dynamic skies and sun study in Cesium for Omniverse. Light is reflecting on the water in San Francisco.

You’ll learn how to:

  • Add a Dynamic Sky to the stage.
  • Configure the Environment Sun Study extension for accurate lighting and shadows.
  • Capture Environment Sun Study imagery and video.

Prerequisites

  • Know how to set up a basic Cesium for Omniverse stage in NVIDIA Omniverse USD Composer 2023.1.1 or newer. Check out our Cesium for Omniverse Quickstart guide for instructions on starting with the Cesium for Omniverse extension.
  • The Cesium for Omniverse samples downloaded.
  • A copy of the USD created during the Lighting the Stage tutorial. A completed USD can be found within the Cesium for Omniverse samples.

1Add a Dynamic Sky

This tutorial assumes that you have already installed the Cesium for Omniverse extension and opened NVIDIA Omniverse USD Composer with the Fabric Scene Delegate settings enabled. If you have not yet done this, see the Quickstart for detailed instructions.

1Open your USD from the Lighting the Stage tutorial, or open /tutorials/02_lighting_the_stage/02_lighting_the_stage.usda from the Cesium for Omniverse samples. You should see Cesium World Terrain along with Aerometrex San Francisco Photogrammetry.

Cesium for Omniverse Dynamic Skies and Sun Study tutorial: Open your USD from the Lighting the Stage tutorial.

2From the Stage panel, select the existing DomeLight and delete it.

Cesium for Omniverse Dynamic Skies and Sun Study tutorial: From the Stage panel, select the existing DomeLight and delete it.

3In the Environments tab, right click on CloudySky and click Set to Stage. A new sky should appear within the stage.

Cesium for Omniverse Dynamic Skies and Sun Study tutorial: In the Environments tab, right click on CloudySky and click Set to Stage. A new sky should appear within the stage.

4The new sky is much more powerful than the previous dome light. Go to Render Settings > Post Processing and enable Auto Exposure. Alternatively, you can set your render settings to use a specific ISO value under Tone Mapping settings.

Cesium for Omniverse Dynamic Skies and Sun Study tutorial: Go to Render Settings > Post Processing and enable Auto Exposure.

5In the Stage, select the Environment prim to configure the sun study location values. You can copy the Latitude and Longitude values from the CesiumGeoreference prim and paste them into the Latitude and Longitude attributes of the Environment prim. This will ensure the sun location accurately reflects the georeferencing location of your stage.

Cesium for Omniverse Dynamic Skies and Sun Study tutorial: In the Stage, select the Environment prim to configure the sun study location values.
Information

Be sure to keep the Environment prim’s location values in sync with the CesiumGeoreference values to ensure accurate lighting.

6Set the North Orientation to 90 degrees. This will ensure the sun correctly rises in the east and sets in the west.

Cesium for Omniverse Dynamic Skies and Sun Study tutorial: Set the North Orientation to 90 degrees.

7Adjust the Time of Day slider to 6 p.m. and confirm the afternoon sun is to the west of San Francisco.

Cesium for Omniverse Dynamic Skies and Sun Study tutorial: Adjust the Time of Day slider to 6 p.m. and confirm the afternoon sun is to the west of San Francisco.

2Environment Sun Study extension

The Environment Sun Study extension provides additional controls for managing the time of day and date, along with capturing video sequences of sun studies.

1Click on Window > Extensions and search for Sun Study. Find the Environment Sun Study extension under Feature and enable it.

Cesium for Omniverse Dynamic Skies and Sun Study tutorial: Find the Environment Sun Study extension under Feature and enable it.

2Click on Window again, and you will see several new options related to Sun Study. These are alternative interfaces to configuring the location, date, and time attributes of the Environment prim. Click on the Sun Study entry to view the Sun Study user interface.

Cesium for Omniverse Dynamic Skies and Sun Study tutorial: Click on the Sun Study entry to view the Sun Study user interface.

3Click the Play button on the Sun Study user interface to watch the sun cycle from morning to afternoon. There are several options for changing the start and end of the cycle, date, and playback speed. For more information on the Environment Sun Study extension, visit the Omniverse documentation.

Cesium for Omniverse Dynamic Skies and Sun Study tutorial: Click the Play button on the Sun Study user interface to watch the sun cycle from morning to afternoon.

4Navigate to a location with tall buildings and move to a top-down style view. Experiment with different dates and times, and capture screenshots by pressing F10 on your keyboard.

Cesium for Omniverse Dynamic Skies and Sun Study tutorial: Navigate to a location with tall buildings and move to a top-down style view. Experiment with different dates and times, and capture screenshots by pressing F10 on your keyboard.

3Capturing a Sun Study video

The Environment Sun Study extension adds a feature to the Omniverse Movie Capture tool that enables video capture of a Sun Study sequence.

1Click Window > Rendering > Movie Capture to open the Movie Capture tool.

Cesium for Omniverse Dynamic Skies and Sun Study tutorial: Click Window > Rendering > Movie Capture to open the Movie Capture tool.

2Adjust the four settings below while leaving the rest at their defaults.

a. Movie Type: The Sunstudy mode will capture a video that starts at the start time of day and finishes at the end time of day. These values can be configured below. 

b. Time of Day: Set the start and end time of days for the sun study movie capture.

c. Movie Length: Set the total length of your sun study movie capture.

d. Format: Capturing to an MP4 makes it easy to quickly view an output, but it is recommended to capture individual frames into lossless formats such as PNG, TGA, or EXR if a professional video editing package is being used to assemble the video.

Cesium for Omniverse Dynamic Skies and Sun Study tutorial: Adjust the four settings below while leaving the rest at their defaults.

3Click Capture Sequence to begin capturing. You can watch the progress of the capture in your viewport.

Cesium for Omniverse Dynamic Skies and Sun Study tutorial: Click Capture Sequence to begin capturing. You can watch the progress of the capture in your viewport.

4Once the capture is complete, you can open your capture path by clicking the folder icon in the Movie Capture tool.

Cesium for Omniverse Dynamic Skies and Sun Study tutorial: Once the capture is complete, you can open your capture path by clicking the folder icon in the Movie Capture tool.
Information

For more information on capturing video, check out the Capturing Images and Video tutorial. 

5Your sun study video should look like the video below:

Next steps

Try importing a proposed architectural model from packages like Revit, SketchUp, or 3ds Max and perform a sun study analysis on the designs.

Content and code examples at cesium.com/learn are available under the Apache 2.0 license. You can use the code examples in your commercial or non-commercial applications.