Official Resources
- Homepage: https://github.com/goodluck1982/SpaceGroupIrep
- Documentation: https://github.com/goodluck1982/SpaceGroupIrep/blob/main/README.md
- Source Repository: https://github.com/goodluck1982/SpaceGroupIrep
- Publication: G.-B. Liu et al., Comput. Phys. Commun. 265, 107993 (2021)
- License: GNU General Public License v3.0
Overview
SpaceGroupIrep is a Mathematica program package providing a comprehensive database and tool set for irreducible representations (IRs) of space groups in the Bradley-Cracknell (BC) convention. It enables calculation of character tables, representation matrices, and compatibility relations for all 230 space groups.
Scientific domain: Crystallographic symmetry, irreducible representations, band theory
Target user community: Condensed matter physicists, materials scientists studying symmetry properties
Theoretical Methods
- Irreducible representations of space groups
- Bradley-Cracknell convention
- Little group representations at high-symmetry k-points
- Compatibility relations between k-points
- Band representation theory
Capabilities (CRITICAL)
- Complete IR Database: All 230 space groups in BC convention
- Character Tables: Full character tables for all little groups
- Representation Matrices: Explicit matrix representations
- Compatibility Relations: Band connectivity analysis
- k-vector Stars: High-symmetry point identification
- Herring Little Groups: Time-reversal symmetry handling
- Band Representations: Elementary band representation decomposition
Sources: SpaceGroupIrep documentation, Comput. Phys. Commun. publication
Key Strengths
Complete BC Convention Coverage:
- All 230 space groups
- Consistent with Bradley-Cracknell book
- Standard crystallographic conventions
- Extensive validation
Mathematica Integration:
- Interactive notebook environment
- Symbolic computation capabilities
- Built-in visualization
- Easy customization
Band Topology Applications:
- Symmetry indicator calculations
- Topological quantum chemistry interface
- Band representation analysis
- Compatibility relation checks
Inputs & Outputs
-
Input formats:
- Space group number
- k-point coordinates
- Symmetry operation specifications
-
Output data types:
- Character tables
- Representation matrices
- Compatibility relations
- Little group elements
Installation
(* Download and extract SpaceGroupIrep package *)
(* Place in Mathematica Applications directory *)
<< SpaceGroupIrep`
Usage Examples
(* Load package *)
<< SpaceGroupIrep`
(* Get little group at Gamma point for space group 225 (Fm-3m) *)
LGIrep[225, {0, 0, 0}]
(* Get character table *)
showLGCharTab[225, "Γ"]
(* Check compatibility relations *)
compatibilityRelation[225, "Γ", "X"]
Performance Characteristics
- Speed: Fast lookup from pre-computed database
- Coverage: Complete for all 230 space groups
- Accuracy: Validated against BC book
Limitations & Known Constraints
- Mathematica required: Needs Mathematica license
- BC convention only: Different from Bilbao convention
- Learning curve: Requires symmetry background
Comparison with Other Tools
- vs IrRep: SpaceGroupIrep Mathematica-based, IrRep Python
- vs spgrep: Different conventions and implementations
- vs Bilbao server: SpaceGroupIrep uses BC convention
- Unique strength: Complete Mathematica package with BC convention
Application Areas
- Topological band theory
- Symmetry analysis of electronic bands
- Elementary band representation calculations
- Topological quantum chemistry
- Crystal field theory
Best Practices
- Verify space group setting matches your structure
- Check BC vs other convention differences
- Use compatibility relations for band connectivity
- Validate results with known materials
Community and Support
- GitHub repository with examples
- Published methodology paper
- Active academic development
Verification & Sources
Primary sources:
- GitHub: https://github.com/goodluck1982/SpaceGroupIrep
- G.-B. Liu et al., Comput. Phys. Commun. 265, 107993 (2021)
Confidence: VERIFIED - Published in CPC
Verification status: ✅ VERIFIED
- Official repository: ACCESSIBLE
- Documentation: AVAILABLE
- Source code: OPEN (GitHub, GPL-3.0)
- Academic citations: CPC publication
- Active development: Maintained