WOLFRAM

Wolfram Language & System Documentation Center

BYU (.byu)

Background & Context

    • 3D geometry format.
    • Used for visualization of 3D polygonal meshes in CAD systems and other applications.
    • BYU is an acronym for Brigham Young University.
    • ASCII format.
    • Represents 3D objects as collections of polygon primitives.
    • Can store multiple 3D objects.

Import & Export

Import Elements

  • General Import elements:
  • "Elements" list of elements and options available in this file
    "Summary"summary of the file
    "Rules"list of rules for all available elements
  • Data format representation elements:
  • "VertexData"list of vertex coordinates
    "PolygonData"the polygon data in indexed form
  • Geometry representation elements:
  • "BoundaryMeshRegion"boundary mesh representation of a solid
    "MeshRegion"mesh representation of a surface
    "Region"region representation of a surface
  • Graphics elements:
  • "Graphics3D"BYU file represented as a Graphics3D object
    "GraphicsComplex"list of GraphicsComplex objects
    "PolygonObjects"list of polygon primitives in absolute coordinates
  • Import and Export use the "MeshRegion" element by default for BYU files.

Examples

open all close all

Basic Examples  (3)

Import a 3D model from BYU as a MeshRegion object:

Wolfram Language code: Import["ExampleData/seashell.byu"]

"Summary" properties of the solid model:

Wolfram Language code: Import["ExampleData/seashell.byu", "Summary"]

Export a 3D model to an ASCII BYU file:

Wolfram Language code: Export["model.byu", [image]]

Print the raw textual contents of the file:

Wolfram Language code: FilePrint[%]

Scope  (11)

Import  (6)

Import works on a BYU file:

Wolfram Language code: Import["ExampleData/chain.byu"]

Any accessible URL:

Wolfram Language code: Import["http://exampledata.wolfram.com/vase.byu"]

Stream:

Wolfram Language code: str = OpenRead["ExampleData/spikey.byu"]
Wolfram Language code: Import[str]
Wolfram Language code: Close[str]

Import automatically detects BYU files:

Wolfram Language code: Import["http://exampledata.wolfram.com/gear.10"]

Import provides access to elements in the BYU file:

Wolfram Language code: Import["ExampleData/seashell.byu", "Elements"]

Import works on large files:

Wolfram Language code: Import["http://exampledata.wolfram.com/turtle.byu"]// MeshCellCount//AbsoluteTiming

Export  (5)

Export works on 3D graphics:

Wolfram Language code: Export["model.byu", [image]]

Special regions:

Wolfram Language code: Export["sphere.byu", Graphics3D[Sphere[]]]

Formula regions:

Wolfram Language code: Export["ball.byu", ImplicitRegion[x ^ 2 + y ^ 2 + z ^ 2 ≤ 1, {x, y, z}]]

Mesh regions:

Wolfram Language code: Export["pyramid.byu", MeshRegion[{{-1, -1, 0}, {1, -1, 0}, {1, 1, 0}, {-1, 1, 0}, {0, 0, 1}}, Pyramid[{1, 2, 3, 4, 5}]]]

Export to an ASCII BYU file:

Wolfram Language code: Export["model.byu", [image]]

Import Elements  (9)

"BoundaryMeshRegion"  (1)

Give a BoundaryMeshRegion:

Wolfram Language code: Import["ExampleData/spikey.byu", "BoundaryMeshRegion"]

"Graphics3D"  (1)

Give the Graphics3D object:

Wolfram Language code: Import["ExampleData/spikey.byu", "Graphics3D"]

"GraphicsComplex"  (1)

Give the GraphicsComplex object:

Wolfram Language code: Import["ExampleData/spikey.byu", "GraphicsComplex"]

"MeshRegion"  (1)

Give the MeshRegion:

Wolfram Language code: Import["ExampleData/spikey.byu", "MeshRegion"]

"PolygonData"  (1)

Give the polygon elements in indexed form:

Wolfram Language code: Import["ExampleData/spikey.byu", "PolygonData"]

"PolygonObjects"  (1)

Give the list of Triangle primitives given in absolute coordinates:

Wolfram Language code: Import["ExampleData/spikey.byu", "PolygonObjects"] // Short

"Region"  (1)

Give a Region:

Wolfram Language code: Import["ExampleData/spikey.byu", "Region"]

"Summary"  (1)

Give the "Summary" of properties:

Wolfram Language code: Import["ExampleData/spikey.byu", "Summary"]

File size:

Wolfram Language code: %["FileSize"]

"VertexData"  (1)

Give the vertex coordinates:

Wolfram Language code: Import["ExampleData/spikey.byu", "VertexData"]