solarwindpy 0.0.1.dev0__py3-none-any.whl → 0.1.0__py3-none-any.whl

plans/completed/docstring-audit-enhancement/2-Core-Physics-Modules-Enhancement.md

@@ -0,0 +1,237 @@
+# Phase 2: Core Physics Modules Format Standardization
+
+## **Objective**
+Standardize docstring formats to NumPy convention compliance for the 9 core physics modules that form the foundation of SolarWindPy's plasma physics analysis capabilities.
+
+## **Scope**
+Convert existing docstrings to strict NumPy format while preserving existing scientific content and adding minimal missing basic documentation.
+
+## **Module Inventory and Format Standardization Targets**
+
+### **High Priority Core Modules (4 modules)**
+
+#### **Module 1: `core/plasma.py` - Primary Plasma Container** (2 hours)
+**Current Status**: Module has documentation but needs NumPy format conversion
+
+**Standardization Requirements:**
+- **Class Documentation**: Convert existing Plasma class docstring to NumPy format
+- **Method Documentation**: Convert 25+ methods to NumPy format with proper parameter notation
+- **Property Documentation**: Add basic Returns sections for properties
+- **Parameter Format**: Convert to `param : type` notation throughout
+
+**Key Format Conversion Example:**
+```python
+class Plasma(base.Base):
+    """Container for plasma physics data including ions, magnetic field, and spacecraft.
+    
+    Parameters
+    ----------
+    data : pandas.DataFrame
+        Multi-indexed DataFrame containing plasma measurements
+    ions : list of str
+        Ion species identifiers (e.g., ['p1', 'a'])
+    spacecraft : Spacecraft, optional
+        Spacecraft trajectory information
+        
+    Attributes
+    ----------
+    species : list
+        Available ion species in the plasma
+    data : pandas.DataFrame
+        Underlying measurement data
+    ions : dict
+        Dictionary of Ion objects keyed by species
+    """
+```
+
+**Format Standardization Areas:**
+- Convert existing docstrings to NumPy parameter format
+- Add missing Returns sections for methods that return values
+- Standardize type notation (array_like, optional, etc.)
+- Ensure consistent section header formatting
+
+#### **Module 2: `core/ions.py` - Ion Species Handling** (2 hours)
+**Current Status**: Has some documentation but needs NumPy format conversion
+
+**Standardization Requirements:**
+- **Ion Class**: Convert existing docstring to NumPy format
+- **Moment Calculations**: Standardize parameter documentation format
+- **Method Documentation**: Add Returns sections where missing
+- **Parameter Format**: Convert to consistent `param : type` notation
+
+**Key Format Focus:**
+- Standardize existing physics equations to proper LaTeX format
+- Convert parameter lists to NumPy parameter section format
+- Add basic docstrings for undocumented methods
+- Ensure consistent Returns section formatting
+
+#### **Module 3: `core/base.py` - Foundation Base Class** (1.5 hours)
+**Current Status**: Has basic documentation requiring NumPy format conversion
+
+**Standardization Requirements:**
+- **Base Class**: Convert existing docstring to NumPy format
+- **Method Documentation**: Standardize parameter and return documentation
+- **Utility Functions**: Add basic docstrings where completely missing
+- **Format Consistency**: Ensure uniform NumPy convention throughout
+
+#### **Module 4: `core/vector.py` - Vector Mathematics** (1 hour)
+**Current Status**: Mathematical operations need NumPy format standardization
+
+**Standardization Requirements:**
+- **Vector Operations**: Convert existing docstrings to NumPy format
+- **Parameter Documentation**: Standardize mathematical parameter notation
+- **Returns Sections**: Add proper return value documentation
+- **LaTeX Format**: Standardize existing mathematical notation formatting
+
+### **Medium Priority Core Modules (3 modules)**
+
+#### **Module 5: `core/spacecraft.py` - Spacecraft Trajectory** (1 hour)
+**Standardization Requirements:**
+- **Format Conversion**: Convert existing docstrings to NumPy format
+- **Parameter Sections**: Standardize coordinate and trajectory parameter documentation
+- **Returns Documentation**: Add missing Returns sections for calculation methods
+
+#### **Module 6: `core/tensor.py` - Tensor Mathematics** (1 hour)
+**Standardization Requirements:**
+- **Format Conversion**: Convert mathematical operation docstrings to NumPy format
+- **Parameter Notation**: Standardize tensor parameter documentation
+- **LaTeX Standardization**: Ensure consistent mathematical notation formatting
+
+#### **Module 7: `core/alfvenic_turbulence.py` - Alfven Wave Analysis** (1.5 hours)
+**Standardization Requirements:**
+- **Format Conversion**: Convert existing physics documentation to NumPy format
+- **Parameter Standardization**: Ensure consistent turbulence parameter documentation
+- **Reference Format**: Standardize existing literature reference formatting
+
+### **Standard Priority Core Modules (2 modules)**
+
+#### **Module 8: `core/units_constants.py` - Physical Constants** (0.5 hours)
+**Standardization Requirements:**
+- **Format Conversion**: Convert constant documentation to NumPy format
+- **Unit Documentation**: Standardize unit specification format
+- **Reference Standardization**: Ensure consistent citation formatting
+
+#### **Module 9: `core/__init__.py` - Package Entry Point** (0.5 hours)
+**Standardization Requirements:**
+- **Module Docstring**: Add basic NumPy format module-level docstring
+- **Import Documentation**: Standardize public API documentation format
+- **Format Consistency**: Ensure NumPy convention compliance
+
+## **Format Standardization Standards for Core Modules**
+
+### **NumPy Format Requirements**
+
+#### **NumPy Parameter Format Standards**
+```python
+def thermal_speed(temperature, mass):
+    """Calculate thermal speed from temperature and mass.
+    
+    Parameters
+    ----------
+    temperature : float or array_like
+        Ion temperature in Kelvin [K]
+    mass : float
+        Ion mass in kilograms [kg]
+        
+    Returns
+    -------
+    float or ndarray
+        Thermal speed in meters per second [m/s]
+    """
+```
+
+#### **Format Consistency Requirements**
+- **Parameter Format**: All parameters with consistent `param : type` notation
+- **Type Documentation**: Standardized type specifications (array_like, optional)
+- **Returns Format**: Consistent return value documentation
+- **Section Headers**: Proper underline formatting for all sections
+
+#### **Conservative Documentation Approach**
+**DO NOT ADD Examples sections to functions that don't already have them**
+
+- **Existing Examples**: Convert existing examples to proper NumPy format
+- **No New Examples**: Do not add Examples sections where they don't exist
+- **Format Focus**: Concentrate on parameter and return documentation
+- **Content Preservation**: Maintain existing scientific content accuracy
+
+### **Format Conversion Framework**
+
+#### **Required Format Conversions**
+- **Parameters**: Convert to NumPy `param : type` format
+- **Returns**: Add Returns sections where missing
+- **Existing Content**: Preserve existing Notes and References
+- **No New Sections**: Do not add new Examples or References
+
+#### **Format Validation Requirements**  
+- **pydocstyle Compliance**: All docstrings pass NumPy convention checks
+- **Parameter Format**: Consistent parameter documentation style
+- **Returns Documentation**: Proper return value format
+- **Section Consistency**: Uniform section header formatting
+
+## **Format Conversion Strategy**
+
+### **Phase 2 Module Processing Order**
+1. **plasma.py** - Highest impact, most methods requiring format conversion
+2. **ions.py** - Core calculations, many methods needing standardization
+3. **base.py** - Foundation class, format affects all derived classes
+4. **vector.py** - Mathematical operations with parameter standardization needs
+5. **alfvenic_turbulence.py** - Specialized module with existing documentation
+6. **spacecraft.py** - Coordinate systems with parameter documentation
+7. **tensor.py** - Mathematical operations requiring format consistency
+8. **units_constants.py** - Constants needing standardized documentation
+9. **__init__.py** - Package entry point requiring basic module docstring
+
+### **Quality Assurance Process**
+1. **Format Conversion**: Convert existing docstrings to NumPy format
+2. **Content Preservation**: Ensure existing scientific content remains accurate
+3. **pydocstyle Validation**: NumPy convention compliance check
+4. **Consistency Review**: Uniform formatting across all modules
+5. **Sphinx Integration**: Verify documentation builds correctly
+
+## **Validation and Testing Criteria**
+
+### **NumPy Convention Compliance**
+- [ ] All public classes have comprehensive docstrings
+- [ ] All public methods follow NumPy parameter/returns format
+- [ ] Properties include proper return value documentation
+- [ ] Module-level docstrings provide comprehensive overviews
+
+### **Format Standardization Standards**
+- [ ] **Parameter Format**: All parameters use NumPy `param : type` notation
+- [ ] **Returns Sections**: All functions returning values have Returns documentation
+- [ ] **Type Consistency**: Standardized type specifications throughout
+- [ ] **Existing Content Preserved**: No loss of existing scientific information
+
+### **Code Quality Checks**
+- [ ] **pydocstyle Compliance**: Zero NumPy convention violations
+- [ ] **Sphinx Integration**: Enhanced documentation builds successfully
+- [ ] **Example Validation**: All docstring examples execute correctly
+- [ ] **Cross-Reference Accuracy**: Internal links and references valid
+
+## **Success Criteria**
+
+### **Primary Format Standardization Goals**
+- **Format Compliance**: All 9 core modules follow NumPy docstring conventions
+- **Content Preservation**: Existing scientific content maintained accurately
+- **Consistency**: Uniform formatting across all core modules
+- **pydocstyle Clean**: Zero violations for NumPy format compliance
+
+### **Quality Metrics**
+- **Zero pydocstyle Violations**: Clean NumPy format compliance
+- **Format Consistency**: Uniform parameter and return documentation
+- **Content Preservation**: No scientific accuracy loss during conversion
+- **Sphinx Compatibility**: Documentation builds without format warnings
+
+## **Integration with Subsequent Phases**
+
+### **Dependencies for Phase 3 (Fitfunctions)**
+- **Format Standards**: Established NumPy convention patterns
+- **Parameter Format**: Consistent mathematical parameter documentation
+- **Validation Framework**: pydocstyle compliance testing established
+
+### **Foundation for Advanced Modules**
+- **Base Class Format**: Foundation NumPy format for all derived classes
+- **Format Standards**: Established consistent documentation patterns
+- **Quality Framework**: pydocstyle validation processes proven effective
+
+This conservative format standardization of core physics modules establishes the NumPy convention foundation for the entire SolarWindPy package, ensuring consistent documentation formatting while preserving scientific integrity.

plans/completed/docstring-audit-enhancement/3-Fitfunctions-Mathematical-Modules-Enhancement.md

@@ -0,0 +1,188 @@
+# Phase 3: Fitfunctions Mathematical Modules Format Standardization
+
+## **Objective**
+Standardize docstring formats to NumPy convention compliance for the 10 fitfunctions modules that provide mathematical curve fitting, statistical analysis, and data modeling capabilities.
+
+## **Scope**
+Convert existing docstrings to strict NumPy format while preserving mathematical content and adding minimal missing basic documentation.
+
+## **Module Inventory and Format Standardization Targets**
+
+### **Critical Foundation Modules (2 modules)**
+
+#### **Module 1: `fitfunctions/core.py` - Abstract FitFunction Base Class** (2 hours)
+**Current Status**: Has documentation requiring NumPy format conversion
+
+**Standardization Requirements:**
+- **FitFunction Class**: Convert existing docstring to NumPy format
+- **Method Documentation**: Standardize parameter and return documentation
+- **Statistical Methods**: Convert existing documentation to NumPy format
+- **Parameter Format**: Ensure consistent `param : type` notation
+
+**Key Format Conversion Focus:**
+- Convert existing optimization documentation to NumPy parameter format
+- Standardize statistical method return documentation
+- Preserve existing mathematical content while fixing format
+- Add basic Returns sections where completely missing
+
+#### **Module 2: `fitfunctions/plots.py` - Fit Visualization Tools** (1.5 hours)
+**Current Status**: Limited documentation requiring format standardization
+
+**Standardization Requirements:**
+- **FFPlot Class**: Convert existing docstrings to NumPy format
+- **Method Documentation**: Add basic docstrings where completely missing
+- **Parameter Format**: Standardize plotting parameter documentation
+- **Returns Documentation**: Add Returns sections for plotting methods
+
+### **Statistical Distribution Modules (4 modules)**
+
+#### **Module 3: `fitfunctions/gaussians.py` - Gaussian Distributions** (1.5 hours)
+**Standardization Requirements:**
+- **Class Documentation**: Convert Gaussian function docstrings to NumPy format
+- **Mathematical Notation**: Standardize existing LaTeX equation formatting
+- **Parameter Documentation**: Convert to consistent `param : type` notation
+- **Property Documentation**: Add Returns sections for statistical properties
+
+#### **Module 4: `fitfunctions/exponentials.py` - Exponential Functions** (1 hour)
+**Standardization Requirements:**
+- **Function Documentation**: Convert exponential function docstrings to NumPy format
+- **Parameter Format**: Standardize decay/growth parameter documentation
+- **Mathematical Format**: Ensure consistent LaTeX formatting for existing equations
+
+#### **Module 5: `fitfunctions/lines.py` - Linear Regression** (1 hour)
+**Standardization Requirements:**
+- **Linear Function**: Convert existing linear fit documentation to NumPy format
+- **Statistical Documentation**: Standardize regression parameter documentation
+- **Returns Format**: Add proper return value documentation
+
+#### **Module 6: `fitfunctions/power_laws.py` - Power Law Functions** (1 hour)
+**Standardization Requirements:**
+- **Power Law Documentation**: Convert existing docstrings to NumPy format
+- **Parameter Format**: Standardize power law parameter documentation
+- **Mathematical Notation**: Ensure consistent LaTeX formatting
+
+### **Specialized Mathematical Modules (3 modules)**
+
+#### **Module 7: `fitfunctions/moyal.py` - Moyal Distribution** (1 hour)
+**Standardization Requirements:**
+- **Moyal Function**: Convert existing specialized distribution documentation
+- **Parameter Format**: Standardize Moyal parameter documentation
+- **Statistical Properties**: Convert existing property documentation to NumPy format
+
+#### **Module 8: `fitfunctions/trend_fits.py` - Trend Analysis** (0.5 hours)
+**Standardization Requirements:**
+- **Trend Functions**: Convert trend analysis documentation to NumPy format
+- **Method Documentation**: Standardize trend calculation parameter format
+
+#### **Module 9: `fitfunctions/tex_info.py` - LaTeX Utilities** (0.5 hours)
+**Standardization Requirements:**
+- **Utility Functions**: Add basic docstrings for LaTeX formatting functions
+- **Parameter Documentation**: Standardize LaTeX utility parameter format
+
+### **Package Infrastructure (1 module)**
+
+#### **Module 10: `fitfunctions/__init__.py` - Package Entry Point** (0.5 hours)
+**Standardization Requirements:**
+- **Module Docstring**: Add basic NumPy format module-level docstring
+- **Import Documentation**: Standardize public API documentation format
+
+## **Format Standardization Standards**
+
+### **NumPy Convention Focus**
+- **Parameter Format**: Convert all parameters to `param : type` notation
+- **Returns Documentation**: Add Returns sections where functions return values
+- **Mathematical Format**: Standardize existing LaTeX equation formatting
+- **Type Consistency**: Use standardized type specifications (array_like, optional)
+
+### **Conservative Approach Guidelines**
+- **DO NOT** add Examples sections to functions that don't already have them
+- **DO NOT** add new mathematical content or equations
+- **DO NOT** add new References sections unless converting existing informal references
+- **DO** preserve all existing mathematical and statistical content
+- **DO** focus on format compliance over content expansion
+
+### **Mathematical Documentation Standards**
+```python
+def gaussian_function(x, amplitude, mean, std):
+    """Gaussian function evaluation.
+    
+    Parameters
+    ----------
+    x : array_like
+        Input values where function is evaluated
+    amplitude : float
+        Peak amplitude parameter
+    mean : float
+        Distribution mean parameter
+    std : float
+        Standard deviation parameter
+        
+    Returns
+    -------
+    ndarray
+        Function values at input points
+    """
+```
+
+## **Implementation Strategy**
+
+### **Phase 3 Module Processing Order**
+1. **core.py** - Foundation class affecting all fitfunction implementations
+2. **plots.py** - Visualization tools with parameter standardization needs
+3. **gaussians.py** - Most commonly used distribution functions
+4. **exponentials.py** - Standard mathematical functions
+5. **lines.py** - Simple linear regression functions
+6. **power_laws.py** - Specialized mathematical functions
+7. **moyal.py** - Advanced statistical distribution
+8. **trend_fits.py** - Trend analysis utilities
+9. **tex_info.py** - LaTeX utility functions
+10. **__init__.py** - Package entry point
+
+### **Quality Assurance Process**
+1. **Format Conversion**: Convert existing docstrings to NumPy format
+2. **Mathematical Preservation**: Ensure existing equations remain accurate
+3. **pydocstyle Validation**: NumPy convention compliance check
+4. **Consistency Review**: Uniform formatting across all fitfunction modules
+5. **Sphinx Integration**: Verify mathematical documentation renders correctly
+
+## **Validation and Testing Criteria**
+
+### **Format Standardization Standards**
+- [ ] **Parameter Format**: All parameters use NumPy `param : type` notation
+- [ ] **Returns Sections**: All functions returning values have Returns documentation
+- [ ] **Mathematical Format**: Existing LaTeX equations properly formatted
+- [ ] **Type Consistency**: Standardized type specifications throughout
+
+### **Code Quality Checks**
+- [ ] **pydocstyle Compliance**: Zero NumPy convention violations
+- [ ] **Mathematical Integrity**: Existing equations and algorithms preserved
+- [ ] **Sphinx Integration**: Documentation builds without mathematical rendering issues
+- [ ] **Format Consistency**: Uniform parameter and return documentation
+
+## **Success Criteria**
+
+### **Primary Format Standardization Goals**
+- **Format Compliance**: All 10 fitfunctions modules follow NumPy docstring conventions
+- **Mathematical Preservation**: Existing mathematical content maintained accurately
+- **Consistency**: Uniform formatting across all fitfunctions modules
+- **pydocstyle Clean**: Zero violations for NumPy format compliance
+
+### **Quality Metrics**
+- **Zero pydocstyle Violations**: Clean NumPy format compliance
+- **Mathematical Integrity**: No loss of existing mathematical documentation
+- **Format Consistency**: Uniform parameter and return documentation
+- **Sphinx Compatibility**: Documentation builds without format warnings
+
+## **Integration with Subsequent Phases**
+
+### **Dependencies for Phase 4 (Plotting)**
+- **Format Standards**: Established NumPy convention patterns for mathematical functions
+- **Parameter Documentation**: Consistent mathematical parameter formatting
+- **LaTeX Standards**: Standardized mathematical notation formatting
+
+### **Foundation for Remaining Modules**
+- **Mathematical Documentation**: Established patterns for scientific function documentation
+- **Format Consistency**: Proven NumPy format conversion processes
+- **Quality Framework**: pydocstyle validation for mathematical modules
+
+This conservative format standardization of fitfunctions modules ensures NumPy convention compliance while preserving the mathematical and statistical integrity essential for scientific curve fitting and analysis.

plans/completed/docstring-audit-enhancement/4-Plotting-Visualization-Modules-Enhancement.md

@@ -0,0 +1,243 @@
+# Phase 4: Plotting Visualization Modules Format Standardization
+
+## **Objective**
+Standardize docstring formats to NumPy convention compliance for the 18 plotting modules that provide data visualization, publication-quality plotting, and interactive analysis capabilities.
+
+## **Scope**
+Convert existing docstrings to strict NumPy format while preserving visualization content and adding minimal missing basic documentation.
+
+## **Module Inventory and Format Standardization Targets**
+
+### **Foundation Plotting Modules (4 modules)**
+
+#### **Module 1: `plotting/base.py` - Base Plotting Infrastructure** (2 hours)
+**Current Status**: Core plotting utilities requiring NumPy format conversion
+
+**Standardization Requirements:**
+- **Base Classes**: Convert existing plotting class docstrings to NumPy format
+- **Method Documentation**: Standardize matplotlib parameter documentation
+- **Parameter Format**: Convert to consistent `param : type` notation
+- **Returns Documentation**: Add Returns sections for plotting methods
+
+#### **Module 2: `plotting/agg_plot.py` - Aggregated Plot Utilities** (1.5 hours)
+**Current Status**: Limited documentation requiring format standardization
+
+**Standardization Requirements:**
+- **Utility Functions**: Add basic docstrings where completely missing
+- **Parameter Format**: Standardize aggregation parameter documentation
+- **Returns Format**: Add proper return value documentation
+
+#### **Module 3: `plotting/histograms.py` - Histogram Plotting (deprecated)** (0.5 hours)
+**Current Status**: Deprecated module requiring minimal format updates
+
+**Standardization Requirements:**
+- **Deprecation Documentation**: Ensure proper deprecation notice formatting
+- **Legacy Format**: Convert existing docstrings to NumPy format
+- **Minimal Updates**: Focus only on format compliance
+
+#### **Module 4: `plotting/tools.py` - General Plotting Tools** (1.5 hours)
+**Current Status**: General utilities requiring format standardization
+
+**Standardization Requirements:**
+- **Tool Functions**: Convert existing utility docstrings to NumPy format
+- **Parameter Documentation**: Standardize plotting tool parameter format
+- **Helper Methods**: Add basic docstrings where missing
+
+### **Histogram Plotting Modules (2 modules)**
+
+#### **Module 5: `plotting/hist1d.py` - 1D Histogram Plots** (1.5 hours)
+**Standardization Requirements:**
+- **Histogram Functions**: Convert existing 1D histogram docstrings to NumPy format
+- **Parameter Format**: Standardize binning and styling parameter documentation
+- **Returns Documentation**: Add Returns sections for histogram objects
+
+#### **Module 6: `plotting/hist2d.py` - 2D Histogram Plots** (1.5 hours)
+**Standardization Requirements:**
+- **2D Histogram Functions**: Convert existing 2D plotting docstrings to NumPy format
+- **Parameter Format**: Standardize 2D binning parameter documentation
+- **Colormap Documentation**: Standardize colormap parameter formatting
+
+### **Specialized Visualization Modules (3 modules)**
+
+#### **Module 7: `plotting/scatter.py` - Scatter Plot Utilities** (1 hour)
+**Standardization Requirements:**
+- **Scatter Functions**: Convert scatter plot docstrings to NumPy format
+- **Parameter Format**: Standardize marker and color parameter documentation
+- **Statistical Overlays**: Convert statistical annotation documentation
+
+#### **Module 8: `plotting/spiral.py` - Spiral Mesh Calculations** (1 hour)
+**Standardization Requirements:**
+- **Spiral Functions**: Convert mesh calculation docstrings to NumPy format
+- **Mathematical Parameters**: Standardize spiral parameter documentation
+- **Coordinate Documentation**: Convert coordinate system parameter format
+
+#### **Module 9: `plotting/orbits.py` - Orbital Trajectory Plots** (1.5 hours)
+**Standardization Requirements:**
+- **Orbital Functions**: Convert trajectory plotting docstrings to NumPy format
+- **Coordinate Parameters**: Standardize orbital parameter documentation
+- **Trajectory Documentation**: Convert existing orbital mechanics documentation
+
+### **Interactive and Selection Modules (1 module)**
+
+#### **Module 10: `plotting/select_data_from_figure.py` - Interactive Data Selection** (1 hour)
+**Standardization Requirements:**
+- **Interactive Functions**: Convert selection tool docstrings to NumPy format
+- **Event Parameters**: Standardize matplotlib event parameter documentation
+- **Callback Documentation**: Convert callback function parameter format
+
+### **Labels Package Modules (8 modules)**
+
+#### **Module 11: `plotting/labels/__init__.py` - Labels Package Entry Point** (0.5 hours)
+**Standardization Requirements:**
+- **Module Docstring**: Add basic NumPy format module-level docstring
+- **Import Documentation**: Standardize labels package API documentation
+
+#### **Module 12: `plotting/labels/base.py` - Base Label Formatting** (1 hour)
+**Standardization Requirements:**
+- **Label Classes**: Convert base label formatting docstrings to NumPy format
+- **Formatting Parameters**: Standardize label formatting parameter documentation
+- **Text Processing**: Convert text processing method documentation
+
+#### **Module 13: `plotting/labels/special.py` - Special Scientific Labels** (1 hour)
+**Standardization Requirements:**
+- **Scientific Labels**: Convert specialized label docstrings to NumPy format
+- **Symbol Parameters**: Standardize scientific symbol parameter documentation
+- **LaTeX Format**: Ensure consistent LaTeX label formatting
+
+#### **Module 14: `plotting/labels/chemistry.py` - Chemical Species Labels** (0.5 hours)
+**Standardization Requirements:**
+- **Chemical Labels**: Convert chemical species docstrings to NumPy format
+- **Species Parameters**: Standardize chemical notation parameter documentation
+
+#### **Module 15: `plotting/labels/composition.py` - Composition Ratio Labels** (0.5 hours)
+**Standardization Requirements:**
+- **Ratio Labels**: Convert composition ratio docstrings to NumPy format
+- **Composition Parameters**: Standardize ratio parameter documentation
+
+#### **Module 16: `plotting/labels/datetime.py` - Time Formatting Labels** (0.5 hours)
+**Standardization Requirements:**
+- **Time Labels**: Convert datetime formatting docstrings to NumPy format
+- **Format Parameters**: Standardize time format parameter documentation
+
+#### **Module 17: `plotting/labels/elemental_abundance.py` - Element Abundance Labels** (0.5 hours)
+**Standardization Requirements:**
+- **Abundance Labels**: Convert element abundance docstrings to NumPy format
+- **Element Parameters**: Standardize abundance parameter documentation
+
+### **Package Infrastructure (1 module)**
+
+#### **Module 18: `plotting/__init__.py` - Package Entry Point** (0.5 hours)
+**Standardization Requirements:**
+- **Module Docstring**: Add basic NumPy format module-level docstring
+- **Import Documentation**: Standardize plotting package API documentation
+
+## **Format Standardization Standards**
+
+### **NumPy Convention Focus**
+- **Parameter Format**: Convert all parameters to `param : type` notation
+- **Returns Documentation**: Add Returns sections where functions return matplotlib objects
+- **Plotting Format**: Standardize matplotlib parameter documentation
+- **Type Consistency**: Use standardized type specifications (array_like, optional)
+
+### **Conservative Approach Guidelines**
+- **DO NOT** add Examples sections to functions that don't already have them
+- **DO NOT** add new plotting functionality or visualization content
+- **DO NOT** add new References sections unless converting existing informal references
+- **DO** preserve all existing matplotlib and visualization content
+- **DO** focus on format compliance over content expansion
+
+### **Plotting Documentation Standards**
+```python
+def scatter_plot(x, y, color=None, marker='o', size=50):
+    """Create scatter plot with scientific formatting.
+    
+    Parameters
+    ----------
+    x : array_like
+        X-axis data values
+    y : array_like
+        Y-axis data values
+    color : array_like or str, optional
+        Color specification for markers
+    marker : str, optional
+        Marker style specification
+    size : float or array_like, optional
+        Marker size specification
+        
+    Returns
+    -------
+    matplotlib.collections.PathCollection
+        Scatter plot collection object
+    """
+```
+
+## **Implementation Strategy**
+
+### **Phase 4 Module Processing Order**
+1. **base.py** - Foundation plotting infrastructure affecting all other modules
+2. **tools.py** - General utilities used across plotting functions
+3. **agg_plot.py** - Aggregation utilities
+4. **hist1d.py** - Common 1D histogram plotting
+5. **hist2d.py** - 2D histogram visualization
+6. **scatter.py** - Scatter plot utilities
+7. **spiral.py** - Specialized mesh calculations
+8. **orbits.py** - Orbital trajectory visualization
+9. **select_data_from_figure.py** - Interactive selection tools
+10. **labels/base.py** - Foundation label formatting
+11. **labels/special.py** - Scientific label utilities
+12. **labels/chemistry.py** - Chemical notation labels
+13. **labels/composition.py** - Composition ratio labels
+14. **labels/datetime.py** - Time formatting labels
+15. **labels/elemental_abundance.py** - Abundance labels
+16. **histograms.py** - Deprecated histogram module
+17. **labels/__init__.py** - Labels package entry
+18. **__init__.py** - Main plotting package entry
+
+### **Quality Assurance Process**
+1. **Format Conversion**: Convert existing docstrings to NumPy format
+2. **Matplotlib Preservation**: Ensure existing plotting functionality remains accurate
+3. **pydocstyle Validation**: NumPy convention compliance check
+4. **Consistency Review**: Uniform formatting across all plotting modules
+5. **Sphinx Integration**: Verify plotting documentation renders correctly
+
+## **Validation and Testing Criteria**
+
+### **Format Standardization Standards**
+- [ ] **Parameter Format**: All parameters use NumPy `param : type` notation
+- [ ] **Returns Sections**: All functions returning matplotlib objects have Returns documentation
+- [ ] **Plotting Format**: Matplotlib parameter documentation standardized
+- [ ] **Type Consistency**: Standardized type specifications throughout
+
+### **Code Quality Checks**
+- [ ] **pydocstyle Compliance**: Zero NumPy convention violations
+- [ ] **Matplotlib Integrity**: Existing plotting functionality preserved
+- [ ] **Sphinx Integration**: Documentation builds without rendering issues
+- [ ] **Format Consistency**: Uniform parameter and return documentation
+
+## **Success Criteria**
+
+### **Primary Format Standardization Goals**
+- **Format Compliance**: All 18 plotting modules follow NumPy docstring conventions
+- **Visualization Preservation**: Existing matplotlib and plotting content maintained accurately
+- **Consistency**: Uniform formatting across all plotting modules
+- **pydocstyle Clean**: Zero violations for NumPy format compliance
+
+### **Quality Metrics**
+- **Zero pydocstyle Violations**: Clean NumPy format compliance
+- **Matplotlib Integrity**: No loss of existing plotting documentation
+- **Format Consistency**: Uniform parameter and return documentation
+- **Sphinx Compatibility**: Documentation builds without format warnings
+
+## **Integration with Subsequent Phases**
+
+### **Dependencies for Phase 5 (Specialized Modules)**
+- **Format Standards**: Established NumPy convention patterns for visualization functions
+- **Parameter Documentation**: Consistent matplotlib parameter formatting
+- **Return Documentation**: Standardized matplotlib object return formatting
+
+### **Foundation for Package Documentation**
+- **Visualization Documentation**: Established patterns for plotting function documentation
+- **Format Consistency**: Proven NumPy format conversion processes for large modules
+- **Quality Framework**: pydocstyle validation for visualization modules
+
+This conservative format standardization of plotting modules ensures NumPy convention compliance while preserving the matplotlib integration and visualization capabilities essential for scientific data analysis and publication-quality plots.