Skip to content
phynite-lab
Phynite DocumentationDownload

Tutorial: a first silicon calculation

Complete a small ground-state calculation before attempting a large material study. This tutorial checks the structure-to-worker-to-result workflow; its numerical settings are starting values for an exercise, not a converged production method.

Complete guide

Before you begin

  • Sign in with the invited account that will own the project and results.
  • Connect Your computer with Docker and keep Docker running while the computer is awake. You may close the terminal once the container is running in the background.
  • Have a diamond-cubic silicon structure in CIF, POSCAR, or another supported format. Keep its source and lattice parameter with your notes.
  • Use a primitive two-atom cell for this exercise. A conventional eight-atom cell is physically valid but has different total energy, reciprocal vectors, and computational cost.

Create and inspect the project

  1. In Workspace, choose New project. Enter Silicon ground state and an optional description, then choose Create project.
  2. Open the new project from the confirmation or project list. Add your silicon structure.
  3. Confirm Si is the only species and the intended primitive cell has two atoms. Inspect cell lengths, angles, units, and nearest neighbors.
  4. Keep a, b, and c periodic for bulk silicon. The displayed repeated cells are a visualization, not extra atoms submitted to the solver.
  5. Give the structure a source-specific name. Retain the original file before changing its lattice.

Configure the exercise

ChoiceStarting pointWhy to inspect it
WorkflowTotal energy / SCFProduces the self-consistent ground state; it does not produce a band-path figure by itself.
MethodPBE with matching Si pseudopotentialChanging the functional or pseudopotential changes the physical model and energy zero.
Wavefunction cutoffUse the resolved pseudopotential recommendationA remembered cutoff from another potential is not transferable evidence of convergence.
Charge-density cutoffUse the matching recommendationThe appropriate ratio depends on the pseudopotential type.
Integration mesh4 × 4 × 4 as an initial exerciseRepeat with denser meshes before interpreting small energy differences.
OccupationsReview the resolved insulating occupation policyDo not infer metallic behavior from a numerical smearing choice.
ResourcesA small allocation within the displayed account limitsAllocation controls available worker resources, not the accuracy of the method.

Run and inspect

  1. Inspect the generated input and select the intended compute destination.
  2. Run once. Open Log and follow Queued, Running, and the final state.
  3. Look for a converged SCF result in the solver output. A finished process without self-consistency is not an acceptable ground state.
  4. Record total energy, atom count, executed input, pseudopotential identity, and run ID.
  5. If you need a dispersion plot, add Band structure and configure a reciprocal path for this cell. Complete it, then choose Open in Figure Lab from its result.

Expected outcome

The project contains the original structure, an editable setup, and a historical execution record with output artifacts. A separate band or DOS run supplies plottable numerical data.

There is no universal target energy for this tutorial: the value depends on the potential, cell, cutoffs, and conventions. Verify internal convergence and consistent method identity instead of matching an unexplained number.

Failure and recovery

  • If the worker is offline, reconnect it and wait for the queued job instead of submitting another.
  • For Failed, inspect the saved input and first meaningful solver error in the log before changing a setting.
  • For Cancelled, keep the partial log and submit a new run only after the prior job reaches a final state.

Related topics