seu-injection-framework 1.1.7__tar.gz

seu_injection_framework-1.1.7/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,134 @@
+name: Bug Report
+description: Report a bug or unexpected behavior in the SEU Injection Framework
+title: "[BUG] "
+labels: ["bug", "triage"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for reporting a bug! Please provide detailed information to help us reproduce and fix the issue.
+        
+        **Before submitting**: Please check existing issues to avoid duplicates.
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Bug Description
+      description: A clear and concise description of what the bug is.
+      placeholder: Describe the unexpected behavior...
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Steps to Reproduce
+      description: Provide minimal code to reproduce the issue
+      placeholder: |
+        1. Import seu_injection
+        2. Create SEUInjector with...
+        3. Run injection with...
+        4. Observe error/unexpected behavior
+      render: python
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Behavior
+      description: What should happen instead?
+      placeholder: Describe what you expected to happen...
+    validations:
+      required: true
+
+  - type: textarea
+    id: error
+    attributes:
+      label: Error Message
+      description: Include full error traceback if applicable
+      placeholder: Paste error message here...
+      render: shell
+
+  - type: dropdown
+    id: environment
+    attributes:
+      label: Environment
+      description: What operating system are you using?
+      options:
+        - Windows
+        - macOS
+        - Linux (Ubuntu/Debian)
+        - Linux (other)
+        - Other
+    validations:
+      required: true
+
+  - type: input
+    id: python-version
+    attributes:
+      label: Python Version
+      description: Output of `python --version`
+      placeholder: "3.11.8"
+    validations:
+      required: true
+
+  - type: input
+    id: framework-version
+    attributes:
+      label: SEU Injection Framework Version
+      description: Output of `pip show seu-injection-framework` or installed version
+      placeholder: "1.0.0"
+    validations:
+      required: true
+
+  - type: input
+    id: torch-version
+    attributes:
+      label: PyTorch Version
+      description: Output of `python -c "import torch; print(torch.__version__)"`
+      placeholder: "2.1.0"
+
+  - type: dropdown
+    id: installation
+    attributes:
+      label: Installation Method
+      description: How did you install the framework?
+      options:
+        - Source install (git clone + uv/pip install -e)
+        - Development install (git clone + uv/pip install -e)
+        - Other
+    validations:
+      required: true
+
+  - type: checkboxes
+    id: cuda
+    attributes:
+      label: CUDA/GPU Information
+      description: Check all that apply
+      options:
+        - label: Issue occurs with GPU/CUDA
+        - label: Issue occurs with CPU only
+        - label: Issue is related to device handling
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Context
+      description: Add any other context, screenshots, or relevant information
+      placeholder: Any additional information that might help...
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Pre-submission Checklist
+      description: Please confirm you have completed these steps
+      options:
+        - label: I have searched existing issues for duplicates
+          required: true
+        - label: I have provided a minimal reproducible example
+          required: true
+        - label: I have included all relevant version information
+          required: true
+        - label: I have tested with the latest version
+          required: true

seu_injection_framework-1.1.7/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,17 @@
+blank_issues_enabled: false
+contact_links:
+  - name: 📚 Documentation
+    url: https://github.com/wd7512/seu-injection-framework/blob/main/README.md
+    about: Read the documentation and examples
+  - name: 🚀 Quick Start Guide
+    url: https://github.com/wd7512/seu-injection-framework/blob/main/docs/quickstart.md
+    about: Get started with basic usage examples
+  - name: 🛠️ Development Setup
+    url: https://github.com/wd7512/seu-injection-framework/blob/main/CONTRIBUTING.md
+    about: Contributing guidelines and development workflow
+  - name: 📊 Research Paper
+    url: https://research-information.bris.ac.uk/en/publications/a-framework-for-developing-robust-machine-learning-models-in-hars
+    about: Read the research methodology and validation
+  - name: ✉️ Direct Contact
+    url: mailto:wd7512@bristol.ac.uk
+    about: Email for security issues or direct communication

seu_injection_framework-1.1.7/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,145 @@
+name: Feature Request
+description: Suggest a new feature or enhancement for the SEU Injection Framework
+title: "[FEATURE] "
+labels: ["enhancement", "triage"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for suggesting a new feature! Please provide detailed information to help us understand your needs.
+        
+        **Before submitting**: Please check existing issues and discussions for similar requests.
+
+  - type: textarea
+    id: summary
+    attributes:
+      label: Feature Summary
+      description: A clear and concise description of the feature you'd like to see
+      placeholder: Brief summary of the proposed feature...
+    validations:
+      required: true
+
+  - type: dropdown
+    id: category
+    attributes:
+      label: Feature Category
+      description: What type of feature is this?
+      options:
+        - Core SEU Injection (new injection methods)
+        - Performance Optimization
+        - API Enhancement
+        - Documentation/Examples
+        - Testing/Quality Assurance
+        - Research Tools
+        - Integration (ML frameworks)
+        - Other
+    validations:
+      required: true
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem Statement
+      description: What problem does this feature solve? What use case does it address?
+      placeholder: |
+        Describe the problem or limitation you're facing...
+        - What research scenario requires this feature?
+        - What current workarounds are you using?
+        - How would this improve your workflow?
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed Solution
+      description: Describe your proposed solution in detail
+      placeholder: |
+        Detailed description of the proposed solution:
+        - API design (if applicable)
+        - Expected behavior
+        - Integration with existing features
+        - Performance considerations
+
+  - type: textarea
+    id: api-example
+    attributes:
+      label: Proposed API (if applicable)
+      description: Show how the feature would be used
+      placeholder: |
+        # Example usage:
+        from seu_injection import SEUInjector
+        
+        injector = SEUInjector(model)
+        result = injector.new_feature(...)
+      render: python
+
+  - type: dropdown
+    id: priority
+    attributes:
+      label: Priority Level
+      description: How important is this feature for your work?
+      options:
+        - Critical (blocking current research)
+        - High (significantly improves workflow)
+        - Medium (nice to have improvement)
+        - Low (minor enhancement)
+
+  - type: textarea
+    id: research-impact
+    attributes:
+      label: Research Impact
+      description: How would this feature benefit the research community?
+      placeholder: |
+        - What research questions could this enable?
+        - Which domains would benefit (space, nuclear, etc.)?
+        - How many researchers might use this feature?
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Considered
+      description: What alternatives have you considered?
+      placeholder: |
+        - Other approaches you've tried
+        - Existing tools that partially solve this
+        - Workarounds currently in use
+
+  - type: checkboxes
+    id: implementation
+    attributes:
+      label: Implementation Considerations
+      description: Check all that apply
+      options:
+        - label: This feature requires new dependencies
+        - label: This feature affects performance-critical paths
+        - label: This feature requires GPU/CUDA support
+        - label: This feature needs extensive testing
+        - label: This feature affects the public API
+        - label: I would be interested in implementing this feature
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Context
+      description: Add any other context, references, or examples
+      placeholder: |
+        - Links to relevant papers or methodologies
+        - Screenshots or diagrams
+        - Related issues or discussions
+        - Comparison with other frameworks
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Pre-submission Checklist
+      description: Please confirm you have completed these steps
+      options:
+        - label: I have searched existing issues for similar requests
+          required: true
+        - label: I have provided sufficient detail about the use case
+          required: true
+        - label: I have considered the impact on existing users
+          required: true
+        - label: I have thought about backward compatibility
+          required: true

seu_injection_framework-1.1.7/.github/ISSUE_TEMPLATE/research_question.yml

@@ -0,0 +1,196 @@
+name: Research Question
+description: Ask questions about SEU injection methodology, framework usage, or research applications
+title: "[RESEARCH] "
+labels: ["research", "question", "discussion"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Welcome to the SEU Injection Framework research community! 
+        
+        This template is for research-oriented questions about methodology, best practices, 
+        experimental design, or framework usage in your research.
+        
+        **For bug reports**: Use the Bug Report template instead
+        **For feature requests**: Use the Feature Request template instead
+
+  - type: dropdown
+    id: question-type
+    attributes:
+      label: Question Category
+      description: What type of research question is this?
+      options:
+        - Methodology (SEU injection strategies)
+        - Experimental Design
+        - Framework Usage
+        - Performance/Optimization
+        - Statistical Analysis
+        - Model Architecture
+        - Research Domain Application
+        - Reproducibility
+        - Other
+    validations:
+      required: true
+
+  - type: textarea
+    id: question
+    attributes:
+      label: Research Question
+      description: Ask your question clearly and provide context
+      placeholder: |
+        State your research question clearly...
+        
+        Include relevant context such as:
+        - Your research domain (space, nuclear, automotive, etc.)
+        - Model architecture you're working with
+        - Specific SEU injection scenario
+        - What you're trying to achieve or understand
+    validations:
+      required: true
+
+  - type: dropdown
+    id: domain
+    attributes:
+      label: Research Domain
+      description: Which application domain is most relevant?
+      options:
+        - Space/Aerospace
+        - Nuclear Systems
+        - Automotive/Transportation
+        - Defense/Military
+        - Industrial Control
+        - Medical Devices
+        - General Fault Tolerance
+        - Academic Research
+        - Other
+
+  - type: dropdown
+    id: model-type
+    attributes:
+      label: Model Architecture
+      description: What type of neural network are you studying?
+      options:
+        - Convolutional Neural Network (CNN)
+        - Fully Connected/Dense Network
+        - Recurrent Neural Network (RNN/LSTM)
+        - Transformer
+        - ResNet/EfficientNet
+        - Custom Architecture
+        - Multiple Architectures
+        - Not Applicable
+
+  - type: textarea
+    id: context
+    attributes:
+      label: Research Context
+      description: Provide background and what you've tried so far
+      placeholder: |
+        Help us understand your research context:
+        
+        - What is your research goal or hypothesis?
+        - What have you tried already?
+        - What specific challenges are you facing?
+        - Are there specific papers or methodologies you're following?
+
+  - type: textarea
+    id: code-example
+    attributes:
+      label: Code Example (if applicable)
+      description: Share relevant code or experimental setup
+      placeholder: |
+        # Share your current approach or what you're trying to implement
+        from seu_injection import SEUInjector
+        
+        # Your experimental setup...
+      render: python
+
+  - type: textarea
+    id: specific-help
+    attributes:
+      label: Specific Help Needed
+      description: What specific guidance or information would be most helpful?
+      placeholder: |
+        Be specific about what would help you most:
+        - Methodological guidance
+        - Code examples
+        - Literature references
+        - Experimental design suggestions
+        - Statistical analysis approaches
+
+  - type: checkboxes
+    id: areas
+    attributes:
+      label: Related Areas
+      description: Check all relevant areas for your research
+      options:
+        - label: Single Event Upset (SEU) physics
+        - label: Radiation effects in electronics
+        - label: Neural network robustness
+        - label: Fault injection methodologies
+        - label: Statistical significance testing
+        - label: Performance optimization
+        - label: Model comparison studies
+        - label: Reproducible research practices
+
+  - type: textarea
+    id: references
+    attributes:
+      label: Relevant References
+      description: Share any papers, resources, or related work
+      placeholder: |
+        Include any relevant:
+        - Research papers you're following
+        - Methodologies you're implementing
+        - Related frameworks or tools
+        - Existing studies in your domain
+
+  - type: dropdown
+    id: urgency
+    attributes:
+      label: Timeline
+      description: What's your timeline for this research?
+      options:
+        - Immediate (within days)
+        - Short-term (within weeks)
+        - Medium-term (within months)
+        - Long-term (exploratory)
+        - No specific timeline
+
+  - type: textarea
+    id: contribution
+    attributes:
+      label: Potential Contribution
+      description: How might your research contribute back to the community?
+      placeholder: |
+        Consider sharing:
+        - Novel methodologies or findings
+        - Benchmark results in new domains
+        - Validation studies
+        - Performance optimizations
+        - Documentation improvements
+
+  - type: checkboxes
+    id: collaboration
+    attributes:
+      label: Collaboration Interest
+      description: Are you interested in collaboration opportunities?
+      options:
+        - label: I'm interested in collaborating with other researchers
+        - label: I'm open to co-authoring publications
+        - label: I would like to contribute results back to the framework
+        - label: I'm interested in reviewing related research
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Pre-submission Checklist
+      description: Please confirm you have completed these steps
+      options:
+        - label: I have searched existing issues and discussions
+          required: true
+        - label: This is a research question (not a bug report or feature request)
+          required: true
+        - label: I have provided sufficient context about my research
+          required: true
+        - label: I am open to community discussion and feedback
+          required: true

seu_injection_framework-1.1.7/.github/workflows/ci.yml

@@ -0,0 +1,58 @@
+name: CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    name: Tests (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.9", "3.10", "3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          version: latest
+      - name: Sync dependencies (dev extra)
+        run: uv sync --extra dev --frozen
+      - name: Run tests with coverage
+        run: uv run pytest tests/ -v --cov=src/seu_injection --cov-report=term --cov-fail-under=50
+      - name: Upload coverage HTML (only latest Python)
+        if: matrix.python-version == '3.11'
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-html
+          path: htmlcov
+
+  lint:
+    name: Lint & Type Check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          version: latest
+      - name: Sync dev dependencies
+        run: uv sync --extra dev --frozen
+      - name: Ruff lint
+        run: uv run ruff check src tests
+      - name: Mypy (loose)
+        run: uv run mypy src/seu_injection --ignore-missing-imports
+      - name: Security scan (bandit)
+        run: uv run bandit -r src/seu_injection -ll -q || echo "Bandit issues found (non-blocking)"

seu_injection_framework-1.1.7/.github/workflows/dependencies.yml

@@ -0,0 +1,48 @@
+name: Update Dependencies
+
+on:
+  schedule:
+    # Run weekly on Sundays at 6 AM UTC
+    - cron: '0 6 * * 0'
+  workflow_dispatch:
+
+jobs:
+  update-deps:
+    runs-on: ubuntu-latest
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+      with:
+        token: ${{ secrets.GITHUB_TOKEN }}
+
+    - name: Install UV
+      uses: astral-sh/setup-uv@v3
+
+    - name: Set up Python 3.11
+      run: uv python install 3.11
+
+    - name: Update dependencies
+      run: |
+        uv lock --upgrade
+        uv sync --all-extras
+
+    - name: Run tests to verify updates
+      run: |
+        uv run python run_tests.py smoke
+        uv run python run_tests.py unit
+
+    - name: Create Pull Request
+      uses: peter-evans/create-pull-request@v5
+      with:
+        token: ${{ secrets.GITHUB_TOKEN }}
+        commit-message: "chore: update dependencies"
+        title: "Automated dependency update"
+        body: |
+          This is an automated pull request to update project dependencies.
+          
+          Please review the changes and run the full test suite before merging.
+          
+          - Dependencies updated via `uv lock --upgrade`
+          - Smoke and unit tests passed
+        branch: deps/auto-update
+        delete-branch: true

seu_injection_framework-1.1.7/.github/workflows/pylint.yml

@@ -0,0 +1,59 @@
+name: Code Quality
+
+on:
+  push:
+    branches: [ main, ai_refactor ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+
+    - name: Install UV
+      uses: astral-sh/setup-uv@v3
+
+    - name: Set up Python 3.11
+      run: uv python install 3.11
+
+    - name: Install dependencies
+      run: uv sync --all-extras
+
+    - name: Run ruff linter
+      run: uv run ruff check src/ tests/ --output-format=github
+
+    - name: Run ruff formatter check
+      run: uv run ruff format src/ tests/ --check
+
+    - name: Run mypy type checking
+      run: uv run mypy src/seu_injection --ignore-missing-imports --no-strict-optional
+      continue-on-error: true
+
+  security:
+    runs-on: ubuntu-latest
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+
+    - name: Install UV
+      uses: astral-sh/setup-uv@v3
+
+    - name: Set up Python 3.11
+      run: uv python install 3.11
+
+    - name: Install dependencies
+      run: uv sync --all-extras
+
+    - name: Run bandit security linter
+      run: uv run bandit -r src/ -f json -o bandit-report.json
+      continue-on-error: true
+
+    - name: Upload security report
+      uses: actions/upload-artifact@v4
+      if: always()
+      with:
+        name: security-report
+        path: bandit-report.json