PDB2AR: Web AR/VR Molecular Content
- PDB2AR is a VMD-based web tool that converts structural data into AR/VR-ready GLB files without requiring manual coding.
- It supports workflows from both PDB files and VMD-exported 3D objects, catering to diverse molecular visualization needs.
- The tool bridges structural data sources with immersive platforms, streamlining custom content creation for MoleculARweb and MolecularWebXR.
PDB2AR is a VMD-based web tool in the moleculARweb and broader MolecularWeb ecosystem that functions as a content generator between structural data and immersive web delivery. In the sources that describe it most directly, PDB2AR is defined as a web app that allows users to create web-based AR and VR sessions for consumer devices, while also serving as the standard route for generating custom molecular content for MolecularWebXR rooms (Rodriguez et al., 2023). Its central role is to transform atomic coordinates or VMD-exported geometry into web-ready assets—most notably GLB files and associated AR/VR web pages—without requiring end users to build WebXR pages, convert 3D formats, or install local molecular-graphics software (Abriata, 4 Sep 2025).
1. Definition and ecosystem position
Within the MolecularWeb ecosystem, PDB2AR is the component responsible for content creation rather than viewing or multiuser interaction. The surrounding platforms play distinct roles: moleculARweb provides AR educational activities, MolecularWebXR provides multiuser WebXR rooms, and PDB2AR provides the authoring pipeline that lets non-programmers populate those environments with their own molecular models (Abriata, 4 Sep 2025). The 2023 MolecularWebXR paper describes this relation explicitly by stating that an empty MolecularWebXR room can be populated with material prepared ad hoc using moleculARweb’s VMD-based PDB2AR tool (Rodriguez et al., 2023).
PDB2AR is therefore best understood as an upstream authoring service. It is not described as embedded inside the MolecularWebXR user interface. Instead, it produces assets that MolecularWebXR later consumes. In that architecture, PDB2AR is the “bridge” between structural data sources—such as PDB files, AlphaFold models, and VMD scenes—and downstream immersive platforms, including marker-based AR, markerless AR, standalone VR, and multiuser MolecularWebXR sessions (Abriata, 4 Sep 2025).
The intended user base is correspondingly broad but technically focused. The MolecularWeb chapter identifies educators, researchers, and science communicators/outreach staff as target users. The motivating problem is that these users often want to display their own structures in AR/VR but do not want to build WebXR applications manually or manage 3D asset conversion and optimization themselves (Abriata, 4 Sep 2025). This positioning makes PDB2AR an authoring tool specialized for molecular visualization on the web rather than a general-purpose structural-biology viewer.
2. Inputs, scene specification, and conversion workflow
PDB2AR supports two primary workflows, described in the MolecularWeb chapter as “Build from PDB” and “Build from 3D object” (VMD-based) (Abriata, 4 Sep 2025). In the first route, users can upload a local PDB file, fetch a structure directly from the Protein Data Bank using its 4-character PDB ID, or retrieve a model from the AlphaFold Protein Structure Database using a UniProt ID. In the second route, users upload Wavefront OBJ + MTL files exported from VMD, which allows arbitrary 3D content rather than only atomistic coordinate sets (Abriata, 4 Sep 2025).
The PDB route is designed primarily for biomolecular structures, including proteins, nucleic acids, small molecules, ions, cofactors, and heterogeneous complexes such as protein–DNA and protein–ligand assemblies (Abriata, 4 Sep 2025). The VMD-object route broadens the scope to any 3D geometry VMD can export, including isosurfaces of cryo-EM density maps, isosurfaces from molecular orbital or electron density calculations, volumetric data converted to surfaces, and custom composite scenes (Abriata, 4 Sep 2025).
The scene-definition process begins with structural input and continues through representation and color selection. PDB2AR parses uploaded or fetched coordinates into logical components—protein chains, nucleic acids, small molecules, ions, and “other” molecules—and presents representation choices that follow VMD conventions. The user may then choose colors according to standard VMD styles. A notable feature is that PDB2AR generates a VMD script corresponding to these choices, and the user can optionally edit that script before rendering in order to adjust representation parameters, change selections, add or remove surfaces, or refine coloring (Abriata, 4 Sep 2025).
After scene specification, the user provides a title and a valid email address. Server-side, PDB2AR runs VMD with the generated script, exports the scene to OBJ/MTL, converts it to GLB, and applies what the chapter describes as “special compression that makes the files light” (Abriata, 4 Sep 2025). The output is then distributed by email.
| Pipeline element | Accepted input | Result |
|---|---|---|
| Build from PDB | Local PDB file, 4-character PDB ID, or AlphaFold model via UniProt ID | VMD-defined molecular scene rendered to AR/VR outputs |
| Build from 3D object | VMD-exported Wavefront OBJ + MTL | GLB asset and AR/VR views for arbitrary VMD-exportable geometry |
| Delivery | Title and valid email address | URLs for cube marker AR, markerless AR, VR, and a direct GLB link |
The MolecularWebXR paper presents the same workflow in a more concise form. Users can create ad hoc content from raw PDB files from the PDB, the AlphaFold-EBI database, or a local upload, as well as from VMD-generated Wavefront objects; they then follow the previously described PDB2AR procedures and copy-paste the link to the GLB file obtained via email into a MolecularWebXR room (Rodriguez et al., 2023).
3. Representational scope and output modalities
PDB2AR’s representational flexibility derives from the fact that its virtual objects are generated with VMD. The MolecularWebXR paper states that it supports all VMD “representations,” ranging from simple ball-and-stick models and cartoons to isosurfaces useful for representing electronic orbitals or cryo-electron maps (Rodriguez et al., 2023). The chapter reiterates this VMD-based logic by describing cartoon, sticks, ball-and-stick, spheres, and surfaces as standard options in the Build from PDB workflow (Abriata, 4 Sep 2025).
This VMD inheritance is important because it determines both the semantic and geometric range of PDB2AR outputs. In the PDB-based route, the tool is oriented toward biomolecular structures and their conventional graphical abstractions. In the VMD-object route, it can package arbitrary geometry that VMD has already generated, including isosurfaces of cryo-EM maps, molecular orbitals, and other volumetric or field-derived surfaces (Abriata, 4 Sep 2025). A plausible implication is that PDB2AR’s scope is broader than “protein viewer” workflows alone; it spans structural biology, chemistry, and field-based visualizations as long as VMD can produce the intermediate geometry.
The outputs are not limited to a single file type. The 2025 chapter states that users receive four deliverables by email: a URL for AR on the cube marker, a URL for markerless AR in the user’s space, a URL for VR headset visualization, and a direct link to the GLB file, explicitly noted as validated for use in MolecularWebXR (Abriata, 4 Sep 2025). These are described as full, ready-to-use mini-webapps, so the user does not need to write HTML or JavaScript.
The downstream interaction modes depend on the platform that consumes the output rather than on PDB2AR itself. In cube-marker AR, the model is attached to the printed cube fiducial marker and follows the marker’s motion. In markerless AR, the object is anchored on a detected surface in the user’s environment. In headset VR, the model appears as a static object in a virtual space. In MolecularWebXR, the same GLB becomes a multiuser object that can be viewed and manipulated collaboratively (Abriata, 4 Sep 2025).
4. Technical implementation and MolecularWebXR integration
The technical stack described for PDB2AR combines a web front end with server-side molecular graphics generation. The MolecularWeb chapter states that PDB2AR is a web app built with HTML5, CSS, JavaScript, Three.js, and WebXR, while relying on VMD server-side to generate the molecular geometry (Abriata, 4 Sep 2025). The client-facing output consists of static HTML/JS pages that load the produced GLB via Three.js and then invoke the appropriate AR or VR behavior.
For marker-based AR, the chapter places PDB2AR’s cube-AR views in the same marker-tracking framework used elsewhere in moleculARweb, namely AR.js and ultimately ARToolKit for marker detection and pose estimation (Abriata, 4 Sep 2025). For markerless AR and VR, the generated pages use the WebXR API for XR session management, head tracking, and plane detection and anchor placement in AR (Abriata, 4 Sep 2025).
The connection to MolecularWebXR is operationally simple and is described as the primary route for custom molecular scenes. In an Empty Room, the host opens the Elements menu, creates new objects, and pastes the GLB URL produced by PDB2AR. MolecularWebXR then loads that GLB into the scene for all users to see (Abriata, 4 Sep 2025). The 2023 paper states the same procedure in slightly different terms: users create content in PDB2AR, obtain the GLB link by email, create an empty MolecularWebXR room, and add the object by URL (Rodriguez et al., 2023).
In MolecularWebXR sessions, the PDB2AR-generated object becomes one of the manipulable VR assets. The multiuser system does not retransmit geometry continuously after loading. Instead, once the room is ready, the platform exchanges quaternions describing object positions, orientations, and scales, together with the hands and head avatars of all users (Rodriguez et al., 2023). This means that PDB2AR chiefly affects initial object download and scene load time, while ongoing network traffic in multiuser use is dominated by transform synchronization rather than repeated transmission of molecular meshes (Rodriguez et al., 2023).
The sources also note a performance-related boundary condition: bandwidth consumption is high when the VR objects are downloaded upon the user entering the room (Rodriguez et al., 2023). That observation applies directly to PDB2AR-generated GLBs when they are used inside MolecularWebXR. The chapter’s statement about “special compression that makes the files light” suggests an explicit attempt to keep these assets suitable for phones, tablets, and standalone headsets, although the compression procedure itself is not specified (Abriata, 4 Sep 2025).
5. Educational, communicative, and research uses
PDB2AR’s principal significance lies in allowing users to construct custom rooms and scenes rather than being restricted to prebuilt examples. The MolecularWebXR paper emphasizes that fully customized content can be created via PDB2AR and that users can quickly create ad hoc content for presentations starting from raw PDB files or VMD-generated objects (Rodriguez et al., 2023). The MolecularWeb chapter extends that claim by stating that prebuilt rooms such as Atomic Orbitals, VSEPR, Structural Biology, and Physics to Biology were also populated by PDB2AR-generated models (Abriata, 4 Sep 2025).
Several concrete deployments are described. In a structural biology conference setting, presenters prepared virtual representations of the structures they presented and used them in synchronized-headset sessions for live scientific discussion (Rodriguez et al., 2023). In science outreach, a 15-minute VR session connecting physics, chemistry, and biology combined custom molecular representations created by PDB2AR with assets obtained from Sketchfab.com (Rodriguez et al., 2023). In course-oriented structural biology rooms, PDB2AR-generated content included nucleosomes, transcription factors bound to DNA, malate synthase G structures from NMR, X-ray, and cryo-EM, carbonic anhydrase with inhibitor, and ABL kinase with imatinib (Abriata, 4 Sep 2025).
The pedagogical value emphasized in the chapter is immediate alignment with teaching goals: instructors can build exactly the structures they want to discuss rather than adapting their syllabus to preexisting examples (Abriata, 4 Sep 2025). The representational options also support concept-specific emphasis. Cartoon versus sticks versus surfaces can be used to foreground hydrogen-bonding patterns, hydrophobic versus polar surface character, the major and minor groove in DNA, or active-site and ligand placement (Abriata, 4 Sep 2025).
The reported user studies and deployments concern the combined PDB2AR-to-MolecularWebXR pipeline rather than PDB2AR’s interface in isolation, but they are still informative about the practical accessibility of the generated assets. The 2023 paper reports that approximately 150 people experienced the 15-minute VR presentation based on PDB2AR-generated content and that none of the participants had to quit the experience prematurely due to VR sickness or other problems (Rodriguez et al., 2023). Users inside VR headsets ranged from 12 to 80 years old, and the paper states that all of them could seamlessly manipulate objects with their hands even when more than 80% had no prior headset experience (Rodriguez et al., 2023). In a separate performance observation, MolecularWebXR was tested with up to 8 simultaneous VR-active users inside VR, an Admin running on a laptop and two passive users, without apparent lag (Rodriguez et al., 2023). These results should be attributed to the full platform stack, but they indicate that PDB2AR-generated content can function effectively in cross-device multiuser settings.
6. Limitations, constraints, and likely developments
The MolecularWeb chapter does not present a formal limitations section solely for PDB2AR, but it identifies several constraints. First, PDB2AR generates static 3D models. It does not provide in-place dynamic molecular mechanics or simulation; the chapter identifies HandMol as the ecosystem component intended for real-time immersive modeling and mechanics (Abriata, 4 Sep 2025). Second, its representation space is bounded by VMD capabilities. Traditional molecular representations and VMD-exportable surfaces are supported, but ultra-custom shader-based effects or volumetric ray-casting are not part of the described output (Abriata, 4 Sep 2025).
Large structures and highly detailed surfaces remain a practical concern. The chapter states that very large assemblies or huge cryo-EM maps should be treated with care and explicitly notes that very large structures may lead to heavy GLBs, even though compression is applied (Abriata, 4 Sep 2025). In MolecularWebXR, this manifests as high bandwidth consumption on first load when the room downloads VR objects (Rodriguez et al., 2023). The workflow also remains email-based: users must provide an email address and wait for links, and the chapter states that no immediate in-browser “download as GLB” workflow is described (Abriata, 4 Sep 2025).
A further limitation is that the chapter does not discuss built-in privacy control for the generated assets or the associated session URLs. In practice, the distribution model is URL-centric and shareable, which means access control is handled socially rather than by a described authorization system (Abriata, 4 Sep 2025). From a usage perspective, the chapter also notes that effective deployment still depends on making good representational choices—for example, cartoon plus sticks rather than all-atoms—so that clarity and performance remain balanced (Abriata, 4 Sep 2025).
Future directions are described only at the ecosystem level, but several likely developments are identified. These include tighter integration with MolecularWebXR, potentially simplifying the path from a newly generated model to a populated XR session; richer representations as the broader platform evolves; and deeper database integration beyond the current direct PDB and AlphaFold fetching (Abriata, 4 Sep 2025). The chapter suggests that even as the ecosystem expands toward real-time modeling, natural-language input, and more advanced simulation tools, PDB2AR will remain the simplest route for bringing high-quality static molecular models into browser-based AR/VR environments (Abriata, 4 Sep 2025).