update readme to have examples

Author: ScottBoyce

README.md

@@ -4,12 +4,25 @@
   <img src="https://github.com/ScottBoyce-Python/DateIntervalCycler/actions/workflows/python-pytest.yml/badge.svg" alt="Build Status" height="20">
 </p>
 
-DynamicVector is a numpy based Python object that stores a vector that can dynamically increase in size. This array supports many python list methods and all the numpy methods. The underlaying numpy array and automatically sized to meet the storate need of the vector.
+DynamicVector is a Python class designed to combine the flexibility of Python lists with the computational efficiency of NumPy arrays. It allows for dynamic resizing, list-like manipulation, and full access to NumPy’s powerful numerical operations. 
 
+## Features
 
+- **Dynamic Resizing**: Automatically expands as new elements are appended or inserted, mimicking Python lists.
+- **NumPy Integration**: Access to all NumPy array operations and methods via the `view` property.
+- **List-Like Functionality**: Supports common list operations such as append, insert, and pop, making it highly versatile.
+- **Optimized for Performance**: Takes advantage of NumPy’s speed and memory efficiency for handling large datasets.
 
 ## Installation
+Ensure that `numpy` is installed in your environment. If not, you can install it using:  
+ (note, this module was only tested against `numpy>2.0`)
+
+```bash
+pip install numpy
+```
+
 To install the module
+
 ```bash
 pip install --upgrade git+https://github.com/ScottBoyce-Python/DynamicVector.git
 ```
@@ -22,43 +35,91 @@ and then move the file `DynamicVector/DynamicVector.py` to wherever you want to
 
 
 ## Usage
-DynamicVector `from_` constructors example:
+
+Below are examples showcasing how to create and interact with a `DynamicVector`.
+
+### Creating a Vector
 
 ```python
-# EXAMPLES GO HERE
+from DynamicVector import DynamicVector
+
+# Initialize with a list
+vec = DynamicVector.from_values([1, 2, 3])  # integer vector with three values
+print(vec)       # Output: DynamicVector([1, 2, 3])
+print(repr(vec)) # Output: DynamicVector([1, 2, 3], dtype=int32)
 ```
 
-&nbsp; 
+### Using NumPy Functions
 
-After running the previous code, the terminal output is:
+```python
+# Access the underlying NumPy array via the 'view' property
+print(vec.view)       # Output: [1 2 3]
+print(vec[:])         # Output: [1 2 3] -> same as vec.view
 
-```
-# EXAMPLES GO HERE
-```
+# Perform NumPy operations
+vec += 1
+print(vec)            # Output: DynamicVector([2, 3, 4])
 
-&nbsp; 
+vec[1] = 99
+print(vec)            # Output: DynamicVector([ 2, 99,  4])
 
- Here is a full example of the DateIntervalCycler class:
+vec[1:len(vec)] = 8   # set element 2 and 3 to the value of 8.
+print(vec)            # Output: DynamicVector([2, 8, 8])
 
-```python
-# EXAMPLES GO HERE
+vec[:] = [2, 3, 4]
+print(vec)            # Output: DynamicVector([2, 3, 4])
 ```
 
-&nbsp; 
+### Appending and Adding Elements
+
+```python
+# Append elements dynamically
+vec.append(5)         # Fast operation
+print(vec)            # Output: DynamicVector([2, 3, 4, 5])
 
-After running the previous code, the terminal output is:
+vec.extend([7, 8, 9]) # Fast operation
+print(vec)            # Output: DynamicVector([1, 2, 3, 5, 7, 8, 9])
 
+# Insert at a specific index
+vec.insert(1, 10)
+print(vec)            # Output: DynamicVector([ 1, 10,  2,  3,  5,  7,  8,  9])
+
+# Insert at a specific index
+vec.insert_values(3, [97, 98])
+print(vec)            # Output: DynamicVector([ 1, 10,  2, 97, 98,  3,  5,  7,  8,  9])
 ```
-# EXAMPLES GO HERE
+
+### Popping Elements
+
+```python
+# Remove and return the last element
+print(vec)            # Output: DynamicVector([ 1, 10,  2, 97, 98,  3,  5,  7,  8,  9])
+last_elem = vec.pop() # Fast operation
+print(vec)            # Output: DynamicVector([ 1, 10,  2, 97, 98,  3,  5,  7,  8])
+print(last_elem)      # Output: 9
+
+third_element = vec.pop(2)
+print(vec)            # Output: DynamicVector([ 1, 10, 97, 98,  3,  5,  7,  8])
+print(third_element)  # Output: 2
 ```
 
+### Slicing
 
+```python
+# Slice behaves like NumPy arrays
+sliced_vec = vec[1:3]
+print(sliced_vec)  # Output: [10  97]
 
-## Testing
+vec[2:5] = [51, 52, 53]
+print(vec)            # Output: DynamicVector([ 1, 10, 51, 52, 53,  5,  7,  8])
 
-This project uses `pytest` and `pytest-xdist` for testing. Tests are located in the `tests` folder. Tests that are very slow are marked as being "slow". The `tests` directory contains multiple subdirectories that contain equivalent slow tests are divided into multiple files to improve parallel execution. The original, slow tests are marked as "slow_skip" and skipped, while the subdirectory tests are marked as "subset".
+vec[[1, 3, 5]] = [-1, -2, -3]
+print(vec)            # Output: DynamicVector([ 1, -1, 51, -2, 53, -3,  7,  8])
+```
+
+## Testing
 
-To run tests, install the required packages and execute the following command:
+This project uses `pytest` and `pytest-xdist` for testing. Tests are located in the `tests` folder. To run tests, install the required packages and execute the following command:
 
 ```bash
 pip install pytest pytest-xdist