Troubleshooting

This guide helps you resolve common issues encountered when using Resource Analyzer. If you experience problems not covered here, please contact PsiQuantum support.

Performance Issues

Slow Graph Loading

If your resource estimate graphs load slowly or become unresponsive:

1. Enable Performance Optimizations

   • Turn on "Hide gates" in Graph Setup
   • Filter costs less than 1%
   • Collapse unused branches
   • Start with a single metric view

2. Large Dataset Handling

   • Start with Collapse All for large graphs
   • Expand sections gradually as needed
   • Use filtering to focus on significant nodes
   • Consider breaking analysis into smaller segments

Performance Optimization

The Hide gates option combined with cost filtering can dramatically improve performance while maintaining analysis quality.

Visualization Issues

Graph Display Problems

If the graph visualization appears incorrect:

1. Layout Issues

   • Try collapsing and re-expanding the graph
   • Refresh the browser
   • Clear browser cache
   • Ensure you're using Google Chrome

2. Color Scaling

   • Verify cost property selection
   • Check scale settings (Log10 vs Linear)
   • Confirm max root cost setting
   • Reset graph settings if needed

Metric Display Issues

When metrics don't appear as expected:

1. Missing Metrics

   • Verify metrics exist in resource estimate
   • Check file format compatibility
   • Ensure estimate generation included desired metrics
   • Review Bartiq configuration if applicable

2. Incorrect Values

   • Confirm correct metric selection
   • Verify scale settings
   • Check for scientific notation interpretation
   • Compare with source data if available

File Handling

Import Problems

If you have trouble importing resource estimates:

1. File Format Issues

   • Ensure file extension is correct (.qre-analysis.json or .basq.dataset.json)
   • Verify file isn't corrupted
   • Check file size (should be less than 100MB)
   • Validate JSON format if possible

2. Loading Errors

   • Clear browser cache
   • Try reloading the page
   • Verify file permissions
   • Check network connectivity

Save and Share Issues

When experiencing problems with saving or sharing:

1. Save Failures

   • Verify project permissions
   • Check available storage space
   • Ensure stable network connection
   • Try saving with fewer expanded nodes

2. Share Link Issues

   • Confirm recipient has project access
   • Verify link format
   • Check organization permissions
   • Try regenerating the share link

Common Error Messages

"Unable to Load Resource Estimate"

This error typically occurs when:

• File format is incorrect
• File is corrupted
• Network connection is unstable
• Browser cache needs clearing

Resolution:

1. Verify file format and contents
2. Clear browser cache
3. Reload the page
4. Regenerate resource estimate if needed

"Graph Rendering Error"

This error appears when:

• Dataset is too large
• Browser resources are constrained
• Graphics hardware is overloaded
• Too many nodes are expanded

Resolution:

1. Enable performance optimizations
2. Reduce visible data (use filters)
3. Refresh the browser
4. Start with collapsed view

Browser Compatibility

Supported Browsers

Resource Analyzer is optimized for Google Chrome.

Browser Support

Other browsers may work but aren't officially supported and may experience issues.

Browser Settings

For optimal performance:

1. Cache Settings

   • Enable browser cache
   • Allocate sufficient cache space
   • Clear cache periodically

2. Hardware Acceleration

   • Enable GPU acceleration
   • Update graphics drivers
   • Close unnecessary tabs

Getting Additional Help

If you encounter issues not covered here:

1. Contact Support

   • Click the "Bug report" icon in Construct
   • Include error messages
   • Describe steps to reproduce
   • Share resource estimate file if possible

2. Documentation

   • Check latest documentation
   • Review release notes
   • Search known issues
   • Consult best practices guides

Support Response

When contacting support, include:

• Browser version
• File size and format
• Error messages
• Steps to reproduce