Tutorial: Plotting spin-polarized EBS & DOS side by side #
This tutorial shows a complete workflow for spin-polarized EBS & DOS plotting in one synchronized figure.
Step 1: Upload files and parse #
Upload the required files for combined plotting. For VASP, PROCAR and DOSCAR are required, while KPOINTS and POSCAR are optional.
Click Parse to load both datasets and generate combined report cards.
Step 2: Review generated report cards #
After parsing, the page generates report cards that summarize key results. You can expect values such as bandgap, material type, Fermi value, lattice parameters, angles, volume, and density. If the simulation is spin-polarized and the bandgaps differ between channels, the report card shows separate Spin ↑ and Spin ↓ bandgap entries.
If you want this report in different units, use the Units panel in the right sidebar.
| Bandgap | 0.00 eV |
| Spin ↑ | 0.00 eV |
| Spin ↓ | 1.20 eV |
| Type | Half-metal |
| CBM | -- |
| VBM | -- |
| Direct | -- |
| Fermi | 4.38 eV |
| Bandgap | 0.00 eV |
| Spin ↑ | 0.00 eV |
| Spin ↓ | 1.17 eV |
| Type | Half-metal |
| Fermi | 4.38 eV |
| a | 3.83 Å |
| b | 3.83 Å |
| c | 3.83 Å |
| α, β, γ | 90°, 90°, 90° |
| Volume | 56.07 ų |
| Density | 4.26 g/cm³ |
Step 3: Set combined limits #
In EBS & DOS mode, the Limits panel has three sections two for x-axis and one for the shared y-axis:
EBS: X min and X max define the x-axis limits for the band-structure plot. You can set these limits using high-symmetry-point indices instead of exact k-point values. For example, for this k-path, setting X min = 0 and X max = 5 plots the range from Γ to X.
DOS: X min and X max for the density of states x-axis.
Shared: Y min and Y max for the common energy axis used by both subplots. In combined mode, the shared y-limits are driven by DOS so both panels remain aligned in energy. For this example we set the energy limits from -5 to 9 eV.
Navigation
Use the quick ribbon controls above the chart to manage interaction behavior while inspecting and presenting figures.
Dark Mode: toggle only the chart styling mode to view the same data in light and dark
figure themes without changing the rest of the page style.
To toggle page dark/light mode, use the top-right button:
/
.
Tooltip: control whether hover readouts and axis-pointer guides are shown. Tooltips are very helpful for inspecting projection contributions. While the axis pointer guides marks the exact x and y position you are of the mouse pointer. Below is an example of a tooltip that appears when you hover over a band segment.
Drag: enable click-and-drag panning of the current zoom window. Use this option to inspect adjacent regions without resetting the zoom.
Zoom Sliders: toggle the axis zoom sliders on or off for interactive zoom control.
Zoom Scroll: enable mouse scroll-wheel zoom interactions. For best results, hold Ctrl while scrolling. You can also hold Ctrl without enabling Zoom Scroll to quickly zoom in and out around the mouse focus.
Zoom Window: enable zooming into a specific rectangular region in a single action.
Step 4: Configure spin-resolved controls in general options #
Figure layout
In EBS & DOS mode, use Figure Layout in General Options to choose whether the DOS panel appears on the left or on the right of the EBS panel. This layout setting controls which subplot is the left figure. In this example we select to plot the density of states on the left.
In the same row, use Area Ratio to control how much horizontal space each subplot
occupies, a good starting point is
EBS = 0.8 and DOS = 0.2.
Spin-resolved line/marker and legend label controls
For spin-polarized data, the General Options panel splits controls into separate Spin Up and Spin Down tiles for both Line/Marker and Legend Label.
Use these tiles to tune line style, marker style, opacity, and plot order per spin channel so overlap remains readable. For legend labels, you can keep auto labels or provide custom labels and text styling per spin.
Step 5: Configure the legend panel #
Use the global Legend panel in the right sidebar to set box position, orientation, item size, spacing, font size, and border/background styling for the combined figure.
In this example we selected to add a background and a border with edge radius 3.
Step 6: Plot spin-polarized EBS & DOS #
With both plain toggles enabled (or with filtered overlays), click Plot to render the combined figure.
During analysis, you can hide or unhide individual spin channels by clicking their items in the legend.
Step 7: Customization and styling #
For axis, legend, font, colors, and other appearance controls, use the right sidebar and see the full settings reference in Plot Settings.
Step 8: Export the figure #
When your figure is ready, click the download button in the chart toolbar to export it. Use this to save a clean image for reports, slides, or publications.
If you download SVG, the figure and element positions remain fully editable when opened in software such as Adobe Illustrator, Inkscape, or GIMP.