Skip to content

raycreate.md

Latest commit

 

History

History
131 lines (89 loc) · 2.63 KB

raycreate.md

File metadata and controls

131 lines (89 loc) · 2.63 KB
Raw

RayCreate

RayCreate is a tool for generating synthetic example ray clouds for testing, demonstration, and algorithm development. It can create various types of 3D structures including rooms, buildings, trees, forests, and terrain.

Usage

Generate from Seed

raycreate <object_type> <seed>
  • <object_type>: The type of object to create (room, building, tree, forest, terrain).
  • <seed>: Random seed number (1-1000000) for reproducible generation.

Generate from File

raycreate <object_type> <input_file>
  • <input_file>: Input file for generating specific structures.

Object Types

room

Generates a simple room structure with walls, ceiling, and floor.

raycreate room 3

building

Creates a more complex building structure with multiple rooms and features.

raycreate building 42

tree

Generates a single tree with branches and foliage structure.

raycreate tree 15

forest

Creates a forest scene with multiple trees and ground structure.

raycreate forest 100

terrain

Generates terrain with elevation variations and surface features.

raycreate terrain 7

File-based Generation

Forest from Tree List

raycreate forest trees.txt

Where trees.txt contains comma-separated values: x,y,z,radius for each tree location.

Terrain from Mesh

raycreate terrain mesh.ply

Generates terrain ray cloud from an input ground mesh file.

Output

The tool generates a ray cloud file with the appropriate name:

  • room_<seed>.ply
  • building_<seed>.ply
  • tree_<seed>.ply
  • forest_<seed>.ply
  • terrain_<seed>.ply

Generated clouds include:

  • Ray start and end points
  • Timing information
  • Color coding based on time
  • Alpha channel indicating bounded/unbounded rays

Examples

Create a room for testing:

raycreate room 42

Generate a forest from a specific seed:

raycreate forest 123

Create terrain from existing mesh:

raycreate terrain ground_model.ply

Build forest from tree location file:

raycreate forest tree_positions.txt

Generate a building for algorithm testing:

raycreate building 999

Additional Information

  • All generated ray clouds include realistic ray timing and coloring
  • Objects are generated with appropriate density and geometric properties
  • Seed values allow reproducible generation for consistent testing
  • For more detailed information on generation algorithms and parameters, refer to the RayCreate source code at raycloudtools/raycreate/raycreate.cpp.