This is documentation for Mathematica 8, which was
based on an earlier version of the Wolfram Language.
View current documentation (Version 11.2)

BYU (.byu)

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 imports the specified element from a BYU file.
  • Import imports multiple elements.
  • Export creates a BYU file by treating expr as specifying element elem.
  • Export treats each as specifying the corresponding .
  • Export exports expr with the specified option elements taken to have the specified values.
  • Export uses rules to specify the elements to be exported.
  • See the reference pages for full general information on Import and Export.
"Elements"list of elements and options available in this file
"Rules"full list of rules for each element and option
"Options"list of rules for options, properties, and settings
"Graphics3D"BYU file represented as a Graphics3D object
"GraphicsComplex"list of GraphicsComplex objects, each representing a 3D geometry stored in the file
  • Data representation elements:
"PolygonData"the polygon data in indexed form
"PolygonObjects"list of Polygon primitives given in absolute coordinates
"VertexData"list of vertex coordinates
  • Import with a data representation element returns a list whose elements correspond to the geometry objects stored in the file.
  • Import gives the polygon data of the n^(th) geometry object.
BackgroundAutomaticwhat background color to use
ImageSizeAutomaticoverall size of the graphics to display
LightingAutomaticwhat simulated lighting to use in coloring 3D surfaces
  • All options of Graphics3D can be given when importing from BYU.
  • Advanced option:
"VerticalAxis"{0,0,1}orientation to assume for the coordinate system used in the file
  • By default, Mathematica assumes that in the coordinate system used by the BYU format the vertical axis corresponds to the third coordinate.
  • With the setting , Mathematica will apply the transformation to all graphics coordinates when importing from BYU, and the inverse transformation when exporting to BYU.
This imports a simple BYU file and renders it as 3D graphics:
Import the GraphicsComplex object representing this sample file:
Read the vertex coordinates:
Import the corresponding polygon information:
Convert the sample file to a list of Polygon primitives:
Use ParametricPlot3D to create a 3D geometry:
Export it to BYU:
Export inline 3D graphics:
This imports a simple BYU file and renders it as 3D graphics:
In[1]:=
Click for copyable input
Out[1]=
Import the GraphicsComplex object representing this sample file:
In[2]:=
Click for copyable input
Out[2]=
Read the vertex coordinates:
In[3]:=
Click for copyable input
Out[3]=
Import the corresponding polygon information:
In[4]:=
Click for copyable input
Out[4]=
Convert the sample file to a list of Polygon primitives:
In[5]:=
Click for copyable input
Out[5]=
 
Use ParametricPlot3D to create a 3D geometry:
In[1]:=
Click for copyable input
Out[1]=
Export it to BYU:
In[2]:=
Click for copyable input
Out[2]=
 
Export inline 3D graphics:
In[1]:=
Click for copyable input
Out[1]=