BathAfrica: Add rewritten practical lesson with steps, code and expected results

2026-10-29T21:01:13Z

Add rewritten practical lesson with steps, code and expected results

New page

__NOTOC__
{{OpenSite scope}}
{{OpenSite lesson
|id=opensite.help.navigate-a-viewport
|summary=Set a standard view and presentation options without changing model quantities.
|prerequisites=A desktop viewport with an open document view. The same calls must handle a headless host or an empty view list.
|steps==== Check availability ===
Test <code>opensite.viewport.available()</code>. A headless host reports that a desktop viewport is unavailable.

=== Select an existing view ===
Read <code>viewport.views()</code> and handle the empty list. Do not invent a view ID.

=== Set presentation ===
Fit all, choose isometric, set orthographic projection and shaded edges, then enable grid and axes.

=== Separate presentation from engineering data ===
Changing camera, projection or grid affects the display. It does not alter section dimensions, units stored in the model or a material’s constitutive values.

|result=A desktop view is fitted and presented with the chosen settings, or the script prints an informative unavailable/no-view message.
|limitations=A viewport foundation is not a general CAD geometry kernel, mesh generator or FEM solver. The example does not create display geometry.
}}

== Complete example ==
{{Code|lang=python|code=<nowiki>import opensite

if not opensite.viewport.available():
print("No desktop viewport in this host.")
else:
views = opensite.viewport.views()
if not views:
print("Open a document view first.")
else:
view = views[0]
opensite.viewport.fit_all(view)
opensite.viewport.standard_view(view, "isometric")
opensite.viewport.set_projection(view, "orthographic")
opensite.viewport.set_style(view, "shaded_edges")
opensite.viewport.set_grid(view, True)
opensite.viewport.set_axes(view, True)
print("View updated; engineering quantities are unchanged.")</nowiki>}}

<div class="os-page-nav">{{Docnav|OpenSite/Guides/Publish a plot|OpenSite/Guides/Set preferences|OpenSite/Guides|All guides}}</div>
[[Category:OpenSite documentation]]

OpenSite/Guides/Navigate a viewport - Revision history

BathAfrica: Add rewritten practical lesson with steps, code and expected results