# jgtads - Advanced Chart Generation

Primary command for generating comprehensive financial charts with multiple indicator overlays and analysis.

## Console Commands
```bash
# Primary modern command
jgtads -i INSTRUMENT -t TIMEFRAME [OPTIONS]

# Legacy equivalent  
adscli -i INSTRUMENT -t TIMEFRAME [OPTIONS]
```

## Parameters
- `-i, --instrument` - Trading pair (e.g., EUR/USD, GBP/USD, USD/JPY)
- `-t, --timeframe` - Period (m1, m5, m15, m30, H1, H4, D1)
- `-c, --count` - Number of bars to chart (default: varies)
- `-ba, --balligator_flag` - Include Bill Williams indicators
- `-ta, --technical_analysis_flag` - Add technical analysis overlays
- `-mw, --mouth_water_flag` - Include mouth/water state indicators
- `-v, --verbose` - Verbosity level

## Usage Examples

### Basic Charting
```bash
# Simple price chart
jgtads -i EUR/USD -t m5 -c 100

# With Bill Williams indicators
jgtads -i EUR/USD -t m5 -c 100 -ba
```

### Advanced Analysis Charts
```bash
# Full indicator suite
jgtads -i GBP/USD -t m15 -c 200 -ba -ta

# Including mouth/water states
jgtads -i USD/JPY -t H1 -c 150 -ba -mw

# Complete analysis with all indicators
jgtads -i EUR/GBP -t m30 -c 300 -ba -ta -mw -v 1
```

### Multi-Timeframe Analysis
```bash
# Scalping setup
jgtads -i EUR/USD -t m1 -c 500 -ba

# Swing trading setup  
jgtads -i GBP/USD -t H4 -c 100 -ba -ta

# Position trading setup
jgtads -i USD/JPY -t D1 -c 50 -ba -ta
```

## Chart Components

### Base Chart
- OHLC candlestick chart
- Volume bars (when available)
- Zone-based background coloring (buy/sell/neutral)

### With `-ba` (Bill Williams)
- Alligator lines (jaw, teeth, lips)
- Awesome Oscillator panel
- Accelerator Oscillator panel  
- Saucer signals
- Fractal markers

### With `-ta` (Technical Analysis)
- MFI (Money Flow Index) indicators
- Additional volume analysis
- Enhanced signal detection

### With `-mw` (Mouth/Water States)
- Mouth direction symbols on price chart
- Water state indicators
- State change markers
- Last completed bar highlighting

## Output
Generates interactive charts with:
- Multiple panels for different indicators
- Zoom and pan capabilities
- Detailed tooltips
- Export options (PNG, HTML)

## Data Source
Uses CDS files generated by `jgtcli`. Ensure data exists:
```bash
# Generate required data first
jgtcli -i EUR/USD -t m5 -c 200 -ba -ta -mw

# Then create charts
jgtads -i EUR/USD -t m5 -c 200 -ba -ta -mw
```

## Integration
Works seamlessly with:
- `jgtcli` generated CDS files
- `jgtmouthwater` for specialized analysis
- `jgtmksg` for signal generation
- Export capabilities for further analysis
