Merge branch 'main' of github.com:apache/mahout

.github/ISSUE_TEMPLATE/issue_template.md

@@ -0,0 +1,32 @@
+## Issue Title  
+<!-- Provide a clear and concise title for the issue -->  
+
+### Description  
+<!-- Describe the issue in detail. Include what the current behavior is and provide any relevant examples or screenshots. -->  
+
+### Steps to Reproduce  
+1. <!-- First step -->  
+2. <!-- Second step -->  
+3. <!-- Third step -->  
+
+### Expected Behavior  
+<!-- What do you expect to happen? -->  
+
+### Actual Behavior  
+<!-- What actually happens? Include any error messages or logs if applicable. -->  
+
+### Environment  
+- **OS:** <!-- e.g. Windows, MacOS, Linux -->  
+- **Browser:** <!-- e.g. Chrome, Firefox, Safari -->  
+- **Version:** <!-- e.g. 1.0.0 -->  
+
+### Suggested Fix  
+<!-- If you have an idea for a fix, please provide details here. -->  
+
+### Additional Context  
+<!-- Add any other context about the problem here. For example, links to related issues or discussions. -->  
+
+### Checklist  
+- [ ] I have searched the existing issues for duplicates.  
+- [ ] I have provided the information as detailed as possible.  
+- [ ] I provided relevant screenshots or files if necessary.  

.github/workflows/notebook-testing.yml

@@ -0,0 +1,34 @@
+name: CI for Jupyter Notebooks
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  test-notebooks:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v2
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.9"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip  
+          pip install nbconvert nbclient ipykernel
+
+      - name: Run Jupyter Notebooks
+        run: |
+          for notebook in $(find . -name '*.ipynb'); do  
+            echo "Executing $notebook"  
+            jupyter nbconvert --to notebook --execute --inplace $notebook  
+          done

docs/api.md

@@ -67,3 +67,9 @@
 ## `execute_circuit(self)`
 - **Purpose**: Executes the quantum circuit and retrieves the results.
 - **Usage**: Used to run the entire set of quantum operations and measure the outcomes.
+
+## `draw_circuit(self)`
+- **Purpose**: Visualizes the quantum circuit.
+- **Usage**: Provides a graphical representation of the quantum circuit for better understanding.
+- **Note**: Just a pass through function, will use underlying libraries 
+  method for drawing circuit. 

qumat/amazon_braket_backend.py

@@ -61,4 +61,10 @@ def execute_circuit(circuit, backend, backend_config):
 
 # placeholder method for use in the testing suite
 def get_final_state_vector(circuit, backend, backend_config):
-    raise NotImplementedError("Final state vector calculation is not currently supported with Amazon Braket.")
+    raise NotImplementedError("Final state vector calculation is not currently supported with Amazon Braket.")
+
+def draw_circuit(circuit):
+    # Unfortunately, Amazon Braket does not have direct support for drawing circuits in the same way
+    # as Qiskit and Cirq. You would typically visualize Amazon Braket circuits using external tools.
+    # For simplicity, we'll print the circuit object which gives some textual representation.
+    print(circuit)

qumat/cirq_backend.py

@@ -71,3 +71,5 @@ def execute_circuit(circuit, backend, backend_config):
     result = simulator.run(circuit, repetitions=backend_config['backend_options'].get('shots', 1))
     return result.histogram(key='result')
 
+def draw_circuit(circuit):
+    print(circuit)

qumat/qiskit_backend.py

@@ -86,3 +86,7 @@ def get_final_state_vector(circuit, backend, backend_config):
     result = job.result()
 
     return result.get_statevector()
+
+def draw_circuit(circuit):
+    # Use Qiskit's built-in drawing function
+    print(circuit.draw())

qumat/qumat.py

@@ -57,4 +57,7 @@ def execute_circuit(self):
 
     # placeholder method for use in the testing suite
     def get_final_state_vector(self):
-        return self.backend_module.get_final_state_vector(self.circuit, self.backend, self.backend_config)
+        return self.backend_module.get_final_state_vector(self.circuit, self.backend, self.backend_config)
+
+    def draw(self):
+        return self.backend_module.draw_circuit(self.circuit)

website/_posts/2024-08-30-Meeting-Minutes.md

@@ -0,0 +1,47 @@
+---
+layout: post
+title: Meeting Minutes
+date:   2024-08-30 00:00:00 -0800
+category: minutes
+---
+## Weekly community meeting
+[Subscribe](mailto:user-subscribe@mahout.apache.org) to the Mahout User list to ask for details on joining.
+
+### Attendees
+* Andrew Musselman
+* Tommy Naugle
+* Trevor Grant
+
+### Old Business
+* [Splitting Mahout project code into discrete repos (andrew)](https://issues.apache.org/jira/projects/MAHOUT/issues/MAHOUT-2204)
+    * mahout-website
+    * mahout-classic
+    * mahout-samsara
+    * mahout-qumat
+* [Docker image for web site build (to jowanza)](https://issues.apache.org/jira/projects/MAHOUT/issues/MAHOUT-2165)
+* [Next steps for qiskit and cirq back ends (sub-tasks created)](https://issues.apache.org/jira/projects/MAHOUT/issues/MAHOUT-2206)
+* [Add Braket (Trevor, done)](https://issues.apache.org/jira/browse/MAHOUT-2213)
+* Roadmap
+    * Q2
+        * Classic in maintenance mode (done)
+    * Q3
+        * Qumat with hardened (tests, docs, CI/CD) cirq and qiskit backends (in flight)
+        * Kernel methods (in flight)
+        * Submit public talk about Qumat (accepted, Fossy Aug 2024)
+        * Amazon Braket (done)
+    * Q4 and beyond
+        * Distributed quantum solvers
+
+### New Business
+* Notebook Testing (#454) (replaces add notebooks to notebooks directory in source tree (https://issues.apache.org/jira/browse/MAHOUT-2198))
+* [Move to GitHub Issues (done)](https://issues.apache.org/jira/projects/MAHOUT/issues/MAHOUT-2205)
+* Added GitHub Issues and Wiki
+* Add GitHub Project
+* [Add "talks" page to web site (for Andrew)](https://github.com/apache/mahout/issues/455)
+* Move to Discord instead of Slack
+* PyPi release for QuMat
+* [Tommy has picked up kernel methods spike](https://issues.apache.org/jira/browse/MAHOUT-2200)
+    - [456](https://github.com/apache/mahout/issues/456)
+    - [457](https://github.com/apache/mahout/issues/457)
+    - [458](https://github.com/apache/mahout/issues/458)
+