> ## Documentation Index
> Fetch the complete documentation index at: https://support.xraysim.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting Started with the Desktop X-ray Simulator

> Learn how to install and launch the Desktop X-ray Simulator, open up your first case, and get familiar with the core controls and workflow.

### Installation and Login

<Steps>
  <Step title="Ensure that your PC meets the hardware requirements">
    [Click here to check the hardware requirements for running the Desktop X-ray Simulator.](/Tech/minimum-requirements-for-running-the-desktop-xray-simulator)
  </Step>

  <Step title="Download and install the newest version of the Desktop X-ray Simulator">
    Download the appropriate platform installer from [the download page.](/Download/download)

    Run the installation file (or drag the .dmg file if on Mac OS).

    <Note>
      NOTICE for IT admins: The Desktop X-Ray Simulator support multi-user PC/workstation installation using MDM systems, like InTune. See the [MDM setup guide](/Tech/mdm-deployment-instructions) for details on running silent installs using command line arguments.
    </Note>
  </Step>

  <Step title="Launch the Desktop X-ray simulator and Login">
    Locate the application on your computer and open it. You will be prompted to log in with your X-ray Simulator account. If you do not have account credentials, reach out to your institution's X-ray Simulator coordinator or review [Accounts and Login](/Guides/Introduction/accounts-and-login).
  </Step>
</Steps>

### Navigation and Controls

<Steps>
  <Step title="Logging in">
    Open the Desktop X-ray Simulator application and enter your X-ray Simulator account username and password on the login screen. Click **Login** to proceed. See [Accounts and Login](/Guides/Introduction/accounts-and-login) if you need to confirm whether you should use an individual student account or a shared station account.

    <Frame>
      <img src="https://mintcdn.com/xraysim/z4pkVVoMee2aPPc1/images/Desktop-xray-sim-login-screen.png?fit=max&auto=format&n=z4pkVVoMee2aPPc1&q=85&s=ea6708e6f5ef40a9319a71deb9280ecf" alt="Desktop Xray Sim Login Screen" width="1812" height="1212" data-path="images/Desktop-xray-sim-login-screen.png" />
    </Frame>
  </Step>

  <Step title="Selecting a case">
    After logging in, you are taken to the case selection screen. Start by choosing a body region in the left column - for example, *Upper extremity and shoulder girdle*. The middle column updates to show available exams for that region; select one to populate the right column with simulation cases. Click the arrow next to a case to load it.

    <Frame>
      <img src="https://mintcdn.com/xraysim/8gx_PvP7LTkO7IwN/images/Desktop-x-ray-simulator-choose-case.png?fit=max&auto=format&n=8gx_PvP7LTkO7IwN&q=85&s=e871e9f1a0bc9a5f03a45e7c3bc2a61b" alt="Desktop X Ray Simulator Choose Case" width="1450" height="964" data-path="images/Desktop-x-ray-simulator-choose-case.png" />
    </Frame>
  </Step>

  <Step title="The simulation workspace">
    Once a case loads, the workspace is divided into three panels. **A** is the overhead 3D view of the room, showing the patient, table, and X-ray tube at a glance. **B** is the secondary viewport, displaying a closer angle of the scene - useful for assessing patient and tube positioning in relation to each other. **C** is the X-ray output panel, which displays the most recent exposure and updates in real time as you adjust parameters.

    <Frame>
      <img src="https://mintcdn.com/xraysim/8gx_PvP7LTkO7IwN/images/desktop-xray-simulator-windows.png?fit=max&auto=format&n=8gx_PvP7LTkO7IwN&q=85&s=382105c8ebbe69304461ac46338625cf" alt="Desktop Xray Simulator Windows" width="3722" height="2475" data-path="images/desktop-xray-simulator-windows.png" />
    </Frame>
  </Step>

  <Step title="Patient controls">
    The **Patient controls** panel **(D)** is at the top of the right sidebar. Use *Choose projection* to switch between AP and Lateral. The sliders below let you adjust joint position - elbow flexion/extension, shoulder rotation, and wrist pronation/supination. Use *Move patient* to reposition the patient on the table.

    <Frame>
      <img src="https://mintcdn.com/xraysim/8gx_PvP7LTkO7IwN/images/Deskotpxraysimpatientcontrols.png?fit=max&auto=format&n=8gx_PvP7LTkO7IwN&q=85&s=4418e91cb004aea4cec93785a1a77f18" alt="Deskotpxraysimpatientcontrols" width="3722" height="2475" data-path="images/Deskotpxraysimpatientcontrols.png" />
    </Frame>
  </Step>

  <Step title="View controls">
    The **View controls** panel **(E)** sits below Patient controls. Use the four view icons under *Choose view* to switch the secondary viewport **(B)** between different camera angles. The *Toggle skin* checkbox switches the patient model between a surface view and a skeletal/transparent view, useful for assessing anatomy and tube alignment.

    <Frame>
      <img src="https://mintcdn.com/xraysim/8gx_PvP7LTkO7IwN/images/desktopxraysimviewcontrols.png?fit=max&auto=format&n=8gx_PvP7LTkO7IwN&q=85&s=3b394cca09d30389163ba89324a0d908" alt="Desktopxraysimviewcontrols" width="3722" height="2475" data-path="images/desktopxraysimviewcontrols.png" />
    </Frame>
  </Step>

  <Step title="Tube positioning">
    The **Tube positioning** panel **(F)** controls the physical position of the X-ray tube. The arrow clusters adjust the tube horizontally and vertically. *SID* (Source-to-Image Distance) is displayed in real time as you move the tube. Use the *Tube angulation*, *Collimator rotation*, and *Column rotation* sliders to fine-tune the angle and orientation of the beam.

    <Frame>
      <img src="https://mintcdn.com/xraysim/8gx_PvP7LTkO7IwN/images/desktopxraysimtubepositioning.png?fit=max&auto=format&n=8gx_PvP7LTkO7IwN&q=85&s=f14f05fcc04bb07c48e0b75bd4e2e996" alt="Desktopxraysimtubepositioning" width="3722" height="2475" data-path="images/desktopxraysimtubepositioning.png" />
    </Frame>
  </Step>

  <Step title="Technique">
    The **Technique** panel **(G)** is where you set your exposure parameters. Adjust *mAs* to control the radiation dose and *kVp* to set the beam energy. The *Collimator cutoff* sliders control field size in the X and Y axes, with the resulting dimensions shown in centimetres and inches below each slider. Changes here are reflected immediately in the X-ray output panel **(C)**.

    <Frame>
      <img src="https://mintcdn.com/xraysim/8gx_PvP7LTkO7IwN/images/desktopxraysimTechnicque.png?fit=max&auto=format&n=8gx_PvP7LTkO7IwN&q=85&s=29e31d2711d3e32b7a01b923332955f2" alt="Desktopxraysim Technicque" width="3722" height="2475" data-path="images/desktopxraysimTechnicque.png" />
    </Frame>
  </Step>

  <Step title="Post processing and image export">
    The **Post processing** panel **(H)** provides two image processing buttons for adjusting the appearance of the exposure. Tick *Show data on image* to overlay exposure parameters directly on the X-ray. Below it, the **Image export** panel **(I)** shows the save location on your computer. Click **Save image** to export the current exposure as an image file to that folder.

    <Frame>
      <img src="https://mintcdn.com/xraysim/50GasdfUJ_qpeWdn/images/desktopxraysimpostpros.png?fit=max&auto=format&n=50GasdfUJ_qpeWdn&q=85&s=47d7c665536e75b6006bd29b5d1127c5" alt="Desktopxraysimpostpros" width="3722" height="2475" data-path="images/desktopxraysimpostpros.png" />
    </Frame>
  </Step>
</Steps>
