seolpyo-mplchart 1.4.1__py3-none-any.whl → 2.0.0.3__py3-none-any.whl

seolpyo_mplchart/__init__.py

@@ -5,43 +5,53 @@ from pathlib import Path
 import matplotlib.pyplot as plt
 import pandas as pd
 
-from ._draw import Chart as _BaseChart
-from ._cursor import Chart as _BaseCursorChart, format_candleinfo_ko, format_volumeinfo_ko, format_candleinfo_en, format_volumeinfo_en
-from ._slider import Chart as _BaseSliderChart
+from ._chart import OnlyChart, CursorChart, SliderChart
+from ._config import DEFAULTCONFIG, DEFAULTCONFIG_EN, SLIDERCONFIG, SLIDERCONFIG_EN, ConfigData, SliderConfigData
 
 
-__all__ = [
-    'path_samsung', 'path_apple',
-    'format_candleinfo_ko', 'format_volumeinfo_ko',
-    'format_candleinfo_en', 'format_volumeinfo_en',
-    'sample', 'switch_backend', 'show', 'close',
-    'OnlyChart', 'CursorChart', 'SliderChart',
-    'set_theme',
-]
+# __all__ = [
+#     'path_samsung', 'path_apple',
+#     'format_candleinfo_ko', 'format_volumeinfo_ko',
+#     'format_candleinfo_en', 'format_volumeinfo_en',
+#     'sample', 'switch_backend', 'show', 'close',
+#     'OnlyChart', 'CursorChart', 'SliderChart',
+#     'set_theme',
+# ]
 
 
-path_samsung = Path(__file__).parent / 'sample/samsung.txt'
-path_apple = Path(__file__).parent / 'sample/apple.txt'
+pkg_name = 'seolpyo_mplchart'
+path_pkg = Path(__file__)
+while path_pkg.name != pkg_name:
+    path_pkg = path_pkg.parent
+path_samsung = path_pkg / 'sample' / 'samsung.txt'
+path_apple = path_pkg / 'sample' / 'apple.txt'
 
 def sample(stock: Literal['samsung', 'apple']='samsung', chart: Literal['Chart', 'CursorChart', 'SliderChart']='SliderChart'):
-    C: _BaseSliderChart = {'Chart': _BaseChart, 'CursorChart': _BaseCursorChart, 'SliderChart': _BaseSliderChart}[chart]()
+    d = {
+        'Chart': OnlyChart,
+        'CursorChart': CursorChart,
+        'SliderChart': SliderChart,
+    }
+    C = d[chart]
     path_file = path_samsung if stock == 'samsung' else path_apple
     if stock == 'samsung':
-        C.format_candleinfo = format_candleinfo_ko
-        C.format_volumeinfo = format_volumeinfo_ko
+        if chart == 'SliderChart':
+            config = SLIDERCONFIG
+        else:
+            config = DEFAULTCONFIG
     else:
-        C.format_candleinfo = format_candleinfo_en
-        C.format_volumeinfo = format_volumeinfo_en
-        C.unit_price = '$'
-        C.unit_volume = 'Vol'
-        C.digit_price = 3
-        C.format_ma = 'ma{}'
+        if chart == 'SliderChart':
+            config = SLIDERCONFIG_EN
+        else:
+            config = DEFAULTCONFIG_EN
+
+    CHART: SliderChart = C(config)
 
     with open(path_file, 'r', encoding='utf-8') as txt:
         data = json.load(txt)
     df = pd.DataFrame(data)
 
-    C.set_data(df)
+    CHART.set_data(df)
 
     show()
     close()
@@ -53,297 +63,123 @@ def switch_backend(newbackend='TkAgg'):
     return plt.switch_backend(newbackend)
 
 
-def show(Close=False):
+def close(fig='all'):
+    "call matplotlib.pyplot.close(fig)"
+    return plt.close(fig)
+
+def show(Close=True):
     """
     call matplotlib.pyplot.show()
     ```if Close``` if True, run matplotlib.pyplot.close('all') after window closee.
     """
     plt.show()
-    if Close: close()
+    if Close:
+        close()
     return
 
 
-def close(fig='all'):
-    "call matplotlib.pyplot.close(fig)"
-    return plt.close(fig)
-
-
-class OnlyChart(_BaseChart):
-    r"""
-    You can see the guidance document:
-        Korean: https://white.seolpyo.com/entry/147/
-        English: https://white.seolpyo.com/entry/148/
-
-    Quick Start:
-        ```
-        import seolpyo_mplchart as mc
-        chart = mc.SliderChart() # Create instance
-        chart.set_data(df) # set stock price data
-        mc.show() # show chart(run ```matplotlib.pyplot.show()```)
-        mc.close() # run ```matplotlib.pyplot.close('close')```
-        ```
-
-    Class Variables:
-        watermark: watermark text.
-
-        figsize: Default size when creating a matplotlib window
-        ratio_ax_legend, ratio_ax_price, ratio_ax_volume: Axes ratio
-        adjust: figure adjust. default ```dict(top=0.95, bottom=0.05, left=0.01, right=0.93, wspace=0, hspace=0)```.
-        color_background: color of background. default '#fafafa'.
-        gridKwargs: kwargs applied to the grid
-        color_tick, color_tick_label: Tick and tick label colors. default ('k', 'k').
-
-        df: stock data DataFrame.
-        date: date column key. default 'date'
-        Open, high, low, close: price column key. default ('open', 'high', 'low', 'close')
-        volume: volume column key. default 'volume'. If ```if self.volume``` is ```False```, the volume chart is not drawn.
-
-        format_ma: moving average legend label format. default '{}일선'
-        list_ma: Decide how many days to draw the moving average line. default (5, 20, 60, 120, 240)
-        list_macolor: Color the moving average line. If the number of colors is greater than the moving average line, black is applied
-
-        candle_on_ma: Decide whether to draw candles on the moving average line. default ```True```
-        color_navigator_line: Color of left and right dividing lines in selected area
-        color_navigator_cover: Color of unselected area.
-
-        color_priceline: The color of the price line
-
-        color_up: The color of the candle. When the closing price is greater than the opening price
-        color_down: The color of the candle. When the opening price is greater than the opening price
-        color_flat: The color of the candle. When the closing price is the same as the opening price
-        color_up_down: The color of the candle. If the closing price is greater than the opening price, but is lower than the previous day's closing price
-        color_down_up: The color of the candle. If the opening price is greater than the closing price, but is higher than the closing price of the previous day
-        colors_volume: The color of the volume bar. default '#1f77b4'
-
-        color_volume_up: The color of the volume. When the closing price is greater than the opening price
-        color_volume_down: The color of the volume. When the opening price is greater than the opening price
-        color_volume_flatt: The color of the volume. When the closing price is the same as the opening price
-
-        candle_width_half, volume_width_half: half of the thickness of the candle and volume
-
-        color_box: The color of the candlebox and volumebox. Used when the mouse is over a candle or volume bar. default 'k'
+def set_theme(config: ConfigData|SliderConfigData, theme: Literal['light', 'dark']='dark'):
+    if theme == 'light':
+        # axes
+        config.FIGURE.facecolor = '#fafafa'
+        config.AX.facecolor = '#fafafa'
+        config.AX.TICK.edgecolor = 'k'
+        config.AX.TICK.fontcolor = 'k'
+        config.AX.GRID.color = '#d0d0d0'
+
+        # candle
+        config.CANDLE.line_color = 'k'
+        config.CANDLE.FACECOLOR.bull_rise = '#FF2400'
+        config.CANDLE.FACECOLOR.bull_fall = 'w'
+        config.CANDLE.FACECOLOR.bear_fall = '#1E90FF'
+        config.CANDLE.FACECOLOR.bear_rise = 'w'
+
+        config.CANDLE.EDGECOLOR.bull_rise = '#FF2400'
+        config.CANDLE.EDGECOLOR.bull_fall = '#FF2400'
+        config.CANDLE.EDGECOLOR.bear_fall = '#1E90FF'
+        config.CANDLE.EDGECOLOR.bear_rise = '#1E90FF'
+        config.CANDLE.EDGECOLOR.doji = 'k'
+
+        # volume
+        config.VOLUME.FACECOLOR.rise = '#F27663'
+        config.VOLUME.FACECOLOR.fall = '#70B5F2'
+        config.VOLUME.FACECOLOR.doji = '#BEBEBE'
+
+        config.VOLUME.EDGECOLOR.rise = '#F27663'
+        config.VOLUME.EDGECOLOR.fall = '#70B5F2'
+        config.VOLUME.EDGECOLOR.doji = '#BEBEBE'
+
+        # ma
+        config.MA.color_default = 'k'
+        config.MA.color_list = ['#8B00FF', '#008000', '#A0522D', '#008B8B', '#FF0080']
+        # text
+        config.CURSOR.TEXT.BBOX.facecolor = 'w'
+        config.CURSOR.TEXT.BBOX.edgecolor = 'k'
+        config.CURSOR.TEXT.color = 'k'
+
+        # box
+        config.CURSOR.BOX.edgecolor = 'k'
+
+        # line
+        config.CURSOR.CROSSLINE.edgecolor = 'k'
+
+        # wartermark
+        config.FIGURE.WATERMARK.color = 'k'
+
+        if getattr(config, 'SLIDER', None):
+            config.SLIDER.NAVIGATOR.edgecolor = '#2962FF'
+            config.SLIDER.NAVIGATOR.facecolor = '#0000002E'
+    elif theme == 'dark':
+        # axes
+        config.FIGURE.facecolor = '#0f0f0f'
+        config.AX.facecolor = '#0f0f0f'
+        config.AX.TICK.edgecolor = '#dbdbdb'
+        config.AX.TICK.fontcolor = '#dbdbdb'
+        config.AX.GRID.color = '#1c1c1c'
+
+        # candle
+        config.CANDLE.line_color = 'w'
+        config.CANDLE.FACECOLOR.bull_rise = '#089981'
+        config.CANDLE.FACECOLOR.bull_fall = '#0f0f0f'
+        config.CANDLE.FACECOLOR.bear_fall = '#f23645'
+        config.CANDLE.FACECOLOR.bear_rise = '#0f0f0f'
+
+        config.CANDLE.EDGECOLOR.bull_rise = '#089981'
+        config.CANDLE.EDGECOLOR.bull_fall = '#089981'
+        config.CANDLE.EDGECOLOR.bear_fall = '#f23645'
+        config.CANDLE.EDGECOLOR.bear_rise = '#f23645'
+        config.CANDLE.EDGECOLOR.doji = 'w'
+
+        # volume
+        config.VOLUME.FACECOLOR.rise = '#2A8076'
+        config.VOLUME.FACECOLOR.fall = '#BE4F58'
+        config.VOLUME.FACECOLOR.doji = '#82828A'
+
+        config.VOLUME.EDGECOLOR.rise = '#2A8076'
+        config.VOLUME.EDGECOLOR.fall = '#BE4F58'
+        config.VOLUME.EDGECOLOR.doji = '#82828A'
+
+        # ma
+        config.MA.color_default = 'w'
+        config.MA.color_list = ['#FFB300', '#03A9F4', '#AB47BC', '#8BC34A', '#EF5350']
+
+        # text
+        config.CURSOR.TEXT.BBOX.facecolor = '#3d3d3d'
+        config.CURSOR.TEXT.BBOX.edgecolor = '#ffffff'
+        config.CURSOR.TEXT.color = '#ffffff'
+
+        # box
+        config.CURSOR.BOX.edgecolor = 'w'
+
+        # line
+        config.CURSOR.CROSSLINE.edgecolor = '#9c9c9c'
+
+        # wartermark
+        config.FIGURE.WATERMARK.color = 'w'
+
+        if getattr(config, 'SLIDER', None):
+            config.SLIDER.NAVIGATOR.edgecolor = "#00A6FF"
+            config.SLIDER.NAVIGATOR.facecolor = '#FFFFFF4D'
+
+    return config
 
-        limit_candle: Maximum number of candles to draw. default 800
-        limit_wick:  Maximum number of candle wicks to draw. default 4,000
-    """
-    pass
-
-
-class CursorChart(_BaseCursorChart):
-    r"""
-    You can see the guidance document:
-        Korean: https://white.seolpyo.com/entry/147/
-        English: https://white.seolpyo.com/entry/148/
-
-    Quick Start:
-        ```
-        import seolpyo_mplchart as mc
-        chart = mc.SliderChart() # Create instance
-        chart.set_data(df) # set stock price data
-        mc.show() # show chart(run ```matplotlib.pyplot.show()```)
-        mc.close() # run ```matplotlib.pyplot.close('close')```
-        ```
-
-    Class Variables:
-        watermark: watermark text.
-
-        unit_price, unit_volume: price and volume unit. default ('원', '주').
-        digit_price, digit_volume: display decimal places when displaying price and volume. default (0, 0),
-
-        figsize: Default size when creating a matplotlib window
-        ratio_ax_legend, ratio_ax_price, ratio_ax_volume: Axes ratio
-        adjust: figure adjust. default ```dict(top=0.95, bottom=0.05, left=0.01, right=0.93, wspace=0, hspace=0)```.
-        color_background: color of background. default '#fafafa'.
-        gridKwargs: kwargs applied to the grid
-        color_tick, color_tick_label: Tick and tick label colors. default ('k', 'k').
-
-        df: stock data DataFrame.
-        date: date column key. default 'date'
-        Open, high, low, close: price column key. default ('open', 'high', 'low', 'close')
-        volume: volume column key. default 'volume'. If ```if self.volume``` is ```False```, the volume chart is not drawn.
-
-        format_ma: moving average legend label format. default '{}일선'
-        list_ma: Decide how many days to draw the moving average line. default (5, 20, 60, 120, 240)
-        list_macolor: Color the moving average line. If the number of colors is greater than the moving average line, black is applied
-
-        candle_on_ma: Decide whether to draw candles on the moving average line. default ```True```
-        color_navigator_line: Color of left and right dividing lines in selected area
-        color_navigator_cover: Color of unselected area.
-
-        color_priceline: The color of the price line
-
-        color_up: The color of the candle. When the closing price is greater than the opening price
-        color_down: The color of the candle. When the opening price is greater than the opening price
-        color_flat: The color of the candle. When the closing price is the same as the opening price
-        color_up_down: The color of the candle. If the closing price is greater than the opening price, but is lower than the previous day's closing price
-        color_down_up: The color of the candle. If the opening price is greater than the closing price, but is higher than the closing price of the previous day
-        colors_volume: The color of the volume bar. default '#1f77b4'
-
-        color_volume_up: The color of the volume. When the closing price is greater than the opening price
-        color_volume_down: The color of the volume. When the opening price is greater than the opening price
-        color_volume_flatt: The color of the volume. When the closing price is the same as the opening price
-
-        candle_width_half, volume_width_half: half of the thickness of the candle and volume
-
-        color_box: The color of the candlebox and volumebox. Used when the mouse is over a candle or volume bar. default 'k'
-
-        lineKwargs: kwarg applied to lines drawn based on mouse cursor position
-        textboxKwargs: kwarg applied to the info text bbox drawn on the chart. When this is applied, the following occurs: ```textKwargs['bbox'] = textboxKwargs```
-        textKwargs: A kwarg that applies to the informational text drawn on the chart. When this is applied, the following occurs: ```textKwargs['bbox'] = textboxKwargs```
-
-        fraction: Decide whether to express information as a fraction. default False
-        format_candleinfo: Candle information text format. default '{dt}\n\n종가:　 {close}\n등락률: {rate}\n대비:　 {compare}\n시가:　 {open}({rate_open})\n고가:　 {high}({rate_high})\n저가:　 {low}({rate_low})\n거래량: {volume}({rate_volume})'
-        format_volumeinfo: Volume information text format. default '{dt}\n\n거래량:　　　 {volume}\n거래량증가율: {rate_volume}\n대비:　　　　 {compare}'
-
-        limit_candle: Maximum number of candles to draw. default 800
-        limit_wick:  Maximum number of candle wicks to draw. default 4,000
-    """
-    pass
-
-
-class SliderChart(_BaseSliderChart):
-    r"""
-    You can see the guidance document:
-        Korean: https://white.seolpyo.com/entry/147/
-        English: https://white.seolpyo.com/entry/148/
-
-    Quick Start:
-        ```
-        import seolpyo_mplchart as mc
-        chart = mc.SliderChart() # Create instance
-        chart.set_data(df) # set stock price data
-        mc.show() # show chart(run ```matplotlib.pyplot.show()```)
-        mc.close() # run ```matplotlib.pyplot.close('close')```
-        ```
-
-    Class Variables:
-        watermark: watermark text.
-
-        unit_price, unit_volume: price and volume unit. default ('원', '주').
-        digit_price, digit_volume: display decimal places when displaying price and volume. default (0, 0),
-
-        figsize: Default size when creating a matplotlib window
-        slider_top: ax_slider is located at the top or bottom. default ```True```.
-        ratio_ax_slider, ratio_ax_legend, ratio_ax_price, ratio_ax_volume: Axes ratio
-        ratio_ax_none: Ratio between volume chart and slider. Used only when ```self.slider_top``` is ```False```
-        adjust: figure adjust. default ```dict(top=0.95, bottom=0.05, left=0.01, right=0.93, wspace=0, hspace=0)```.
-        color_background: color of background. default '#fafafa'.
-        gridKwargs: kwargs applied to the grid
-        color_tick, color_tick_label: Tick and tick label colors. default ('k', 'k').
-
-        df: stock data DataFrame.
-        date: date column key. default 'date'
-        Open, high, low, close: price column key. default ('open', 'high', 'low', 'close')
-        volume: volume column key. default 'volume'. If ```if self.volume``` is ```False```, the volume chart is not drawn.
-
-        format_ma: moving average legend label format. default '{}일선'
-        list_ma: Decide how many days to draw the moving average line. default (5, 20, 60, 120, 240)
-        list_macolor: Color the moving average line. If the number of colors is greater than the moving average line, black is applied
-
-        candle_on_ma: Decide whether to draw candles on the moving average line. default ```True```
-        color_navigator_line: Color of left and right dividing lines in selected area
-        color_navigator_cover: Color of unselected area.
-
-        color_priceline: The color of the price line
-
-        color_up: The color of the candle. When the closing price is greater than the opening price
-        color_down: The color of the candle. When the opening price is greater than the opening price
-        color_flat: The color of the candle. When the closing price is the same as the opening price
-        color_up_down: The color of the candle. If the closing price is greater than the opening price, but is lower than the previous day's closing price
-        color_down_up: The color of the candle. If the opening price is greater than the closing price, but is higher than the closing price of the previous day
-        colors_volume: The color of the volume bar. default '#1f77b4'
-
-        color_volume_up: The color of the volume. When the closing price is greater than the opening price
-        color_volume_down: The color of the volume. When the opening price is greater than the opening price
-        color_volume_flatt: The color of the volume. When the closing price is the same as the opening price
-
-        candle_width_half, volume_width_half: half of the thickness of the candle and volume
-
-        color_box: The color of the candlebox and volumebox. Used when the mouse is over a candle or volume bar. default 'k'
-
-        lineKwargs: kwarg applied to lines drawn based on mouse cursor position
-        textboxKwargs: kwarg applied to the info text bbox drawn on the chart. When this is applied, the following occurs: ```textKwargs['bbox'] = textboxKwargs```
-        textKwargs: A kwarg that applies to the informational text drawn on the chart. When this is applied, the following occurs: ```textKwargs['bbox'] = textboxKwargs```
-
-        fraction: Decide whether to express information as a fraction. default False
-        format_candleinfo: Candle information text format. default '{dt}\n\n종가:　 {close}\n등락률: {rate}\n대비:　 {compare}\n시가:　 {open}({rate_open})\n고가:　 {high}({rate_high})\n저가:　 {low}({rate_low})\n거래량: {volume}({rate_volume})'
-        format_volumeinfo: Volume information text format. default '{dt}\n\n거래량:　　　 {volume}\n거래량증가율: {rate_volume}\n대비:　　　　 {compare}'
-
-        min_distance: Minimum number of candles that can be selected with the slider. default 30
-        limit_candle: Maximum number of candles to draw. default 800
-        limit_wick:  Maximum number of candle wicks to draw. default 4,000
-        limit_volume: Maximum number of volume bars to draw. default 200. Applies only to drawing candle wicks or price line.
-        limit_ma: If the number of displayed data is more than this, the price moving average line is not drawn. default 8,000
-
-        color_navigator_line: Navigator divider color. default '#1e78ff'
-        color_navigator_cover: Unselected slider area color. default = 'k'
-    """
-    pass
-
-
-def set_theme(chart: SliderChart|CursorChart|OnlyChart, theme: Literal['light', 'dark']='dark'):
-    initialized = hasattr(chart, 'ax_price')
-
-    if theme == 'dark':
-        chart.color_background = '#000000'
-        chart.color_tick, chart.color_tick_label = ('w', 'w')
-        chart.gridKwargs = {'color': '#FFFFFF'}
-
-        chart.color_priceline = 'w'
-        chart.color_up, chart.color_down = ('#00FF00', '#FF0000')
-        chart.color_flat = 'w'
-        chart.color_up_down, chart.color_down_up = ('#000000', '#000000')
-
-        chart.color_volume_up, chart.color_volume_down = ('#32CD32', '#FF4500')
-        chart.color_volume_flat = 'w'
-
-        chart.list_macolor = ('#1E90FF', '#FFA500', '#FF1493', '#FFFF00', '#00CED1')
-
-        chart.lineKwargs = {'edgecolor': 'w'}
-        chart.color_box = 'w'
-        chart.textboxKwargs = {'facecolor': 'k', 'edgecolor': 'w'}
-        chart.textKwargs = {'color': 'w'}
-        chart.color_navigator_cover, chart.color_navigator_line = ('k', '#FF2400')
-
-        if initialized:
-            chart.change_background_color('k')
-            chart.change_tick_color('w')
-            chart.change_line_color('w')
-            if hasattr(chart, 'navigator'): chart.collection_navigator.set_edgecolor([chart.color_navigator_cover, chart.color_navigator_line])
-
-            if hasattr(chart, 'df'):
-                chart.set_data(chart.df, sort_df=False, calc_ma=False, set_candlecolor=True, set_volumecolor=True, calc_info=False, change_lim=False)
-                chart.draw_canvas()
-    elif theme == 'light':
-        chart.color_background = '#fafafa'
-        chart.color_tick, chart.color_tick_label = ('k', 'k')
-        chart.gridKwargs = {'color': '#d0d0d0'}
-
-        chart.color_priceline = 'k'
-        chart.color_up, chart.color_down = ('#FF2400', '#1E90FF')
-        chart.color_flat = 'k'
-        chart.color_up_down, chart.color_down_up = ('w', 'w')
-
-        chart.color_volume_up, chart.color_volume_down = ('#FF6666', '#5CA8F4')
-        chart.color_volume_flat = '#808080'
-
-        chart.list_macolor = ('#006400', '#8B008B', '#FFA500', '#0000FF', '#FF0000')
-
-        chart.lineKwargs = {'edgecolor': 'k'}
-        chart.color_box = 'k'
-        chart.textboxKwargs = {'facecolor': 'w', 'edgecolor': 'k'}
-        chart.textKwargs = {'color': 'k'}
-        chart.color_navigator_cover, chart.color_navigator_line = ('k', '#1E78FF')
-
-        if initialized:
-            chart.change_background_color('#fafafa')
-            chart.change_tick_color('k')
-            chart.change_line_color('k')
-            if hasattr(chart, 'navigator'): chart.collection_navigator.set_edgecolor([chart.color_navigator_cover, chart.color_navigator_line])
-
-            if hasattr(chart, 'df'):
-                chart.set_data(chart.df, sort_df=False, calc_ma=False, set_candlecolor=True, set_volumecolor=True, calc_info=False, change_lim=False)
-                chart.draw_canvas()
-    else: raise ValueError(f'You send wrong arg.\n{theme=}')
-
-    return chart

seolpyo_mplchart/_chart/__init__.py

@@ -0,0 +1,137 @@
+from ._draw import Chart as _OC
+from ._cursor import Chart as _CC
+from ._slider import Chart as _SC
+
+
+
+class OnlyChart(_OC):
+    r"""
+    You can see the guidance document:
+        Korean: https://white.seolpyo.com/entry/147/?from=package
+        English: https://github.com/white-seolpyo/seolpyo-mplchart/blob/main/README.md
+
+    Quick Start:
+        ```
+        import seolpyo_mplchart as mc
+        chart = mc.SliderChart() # Create instance
+        chart.set_data(df) # set stock price data
+        mc.show() # show chart(run ```matplotlib.pyplot.show()```)
+        mc.close() # run ```matplotlib.pyplot.close('close')```
+        ```
+
+    Class Variables:
+        watermark: watermark text.
+
+        df: stock data DataFrame.
+        key_date: date column key. default 'date'
+        key_open, key_high, key_low, key_close: price column key. default ('open', 'high', 'low', 'close')
+        key_volume: volume column key. default 'volume'. If ```if config.VOLUME.EDGECOLOR.volume``` is ```False```, the volume chart is not drawn.
+
+        cnadle_on_ma: if True: draw candle above ma. else: draw candle below ma lines.
+        limit_candle: If (`the number of candles to draw < limit_candle or not limit_candle`): draw candles, else: draw wicks.
+        limit_wick: If (`the number of candles to draw < limit_wick or not limit_wick`): draw wicks, else: draw line.
+        limit_volume: If (`the number of candles to draw < limit_volume or not limit_volume`): draw volumebar, else: draw wicks.
+        limit_ma: If (`the number of candles to draw < limit_ma or not limit_ma`): draw ma lines, else: don't draw ma lines.
+        fraction: if True and number has a fractional part, display it as a fraction.
+    """
+    key_date = 'date'
+    key_open, key_high, key_low, key_close = ('open', 'high', 'low', 'close')
+    key_volume = 'volume'
+
+    candle_on_ma = True
+    limit_candle = 400
+    limit_wick = 2_000
+    limit_volume = 200
+    limit_ma = None
+    watermark = 'seolpyo mplchart'
+
+
+class CursorChart(_CC):
+    r"""
+    You can see the guidance document:
+        Korean: https://white.seolpyo.com/entry/147/?from=package
+        English: https://github.com/white-seolpyo/seolpyo-mplchart/blob/main/README.md
+
+    Quick Start:
+        ```
+        import seolpyo_mplchart as mc
+        chart = mc.SliderChart() # Create instance
+        chart.set_data(df) # set stock price data
+        mc.show() # show chart(run ```matplotlib.pyplot.show()```)
+        mc.close() # run ```matplotlib.pyplot.close('close')```
+        ```
+
+    Class Variables:
+        watermark: watermark 
+
+        df: stock data DataFrame.
+        key_date: date column key. default 'date'
+        key_open, key_high, key_low, key_close: price column key. default ('open', 'high', 'low', 'close')
+        key_volume: volume column key. default 'volume'. If ```if config.VOLUME.EDGECOLOR.volume``` is ```False```, the volume chart is not drawn.
+
+        cnadle_on_ma: if True: draw candle above ma. else: draw candle below ma lines.
+        limit_candle: If (`the number of candles to draw < limit_candle or not limit_candle`): draw candles, else: draw wicks.
+        limit_wick: If (`the number of candles to draw < limit_wick or not limit_wick`): draw wicks, else: draw line.
+        limit_volume: If (`the number of candles to draw < limit_volume or not limit_volume`): draw volumebar, else: draw wicks.
+        limit_ma: If (`the number of candles to draw < limit_ma or not limit_ma`): draw ma lines, else: don't draw ma lines.
+        fraction: if True and number has a fractional part, display it as a fraction.
+    """
+    key_date = 'date'
+    key_open, key_high, key_low, key_close = ('open', 'high', 'low', 'close')
+    key_volume = 'volume'
+
+    candle_on_ma = True
+    limit_candle = 400
+    limit_wick = 2_000
+    limit_volume = 200
+    limit_ma = None
+    watermark = 'seolpyo mplchart'
+    fraction = False
+
+
+class SliderChart(_SC):
+    r"""
+    You can see the guidance document:
+        Korean: https://white.seolpyo.com/entry/147/?from=package
+        English: https://github.com/white-seolpyo/seolpyo-mplchart/blob/main/README.md
+
+    Quick Start:
+        ```
+        import seolpyo_mplchart as mc
+        chart = mc.SliderChart() # Create instance
+        chart.set_data(df) # set stock price data
+        mc.show() # show chart(run ```matplotlib.pyplot.show()```)
+        mc.close() # run ```matplotlib.pyplot.close('close')```
+        ```
+
+    Class Variables:
+        watermark: watermark text.
+
+        df: stock data DataFrame.
+        key_date: date column key. default 'date'
+        key_open, key_high, key_low, key_close: price column key. default ('open', 'high', 'low', 'close')
+        key_volume: volume column key. default 'volume'. If ```if config.VOLUME.EDGECOLOR.volume``` is ```False```, the volume chart is not drawn.
+
+        cnadle_on_ma: if True: draw candle above ma. else: draw candle below ma lines.
+        limit_candle: If (`the number of candles to draw < limit_candle or not limit_candle`): draw candles, else: draw wicks.
+        limit_wick: If (`the number of candles to draw < limit_wick or not limit_wick`): draw wicks, else: draw line.
+        limit_volume: If (`the number of candles to draw < limit_volume or not limit_volume`): draw volumebar, else: draw wicks.
+        limit_ma: If (`the number of candles to draw < limit_ma or not limit_ma`): draw ma lines, else: don't draw ma lines.
+        fraction: if True and number has a fractional part, display it as a fraction.
+        slider_top: set slider position. if True: slider top. else: bottom
+        min_distance: the minimum number of candles displayed on the screen.
+    """
+    key_date = 'date'
+    key_open, key_high, key_low, key_close = ('open', 'high', 'low', 'close')
+    key_volume = 'volume'
+
+    candle_on_ma = True
+    limit_candle = 400
+    limit_wick = 2_000
+    limit_volume = 200
+    limit_ma = 8_000
+    watermark = 'seolpyo mplchart'
+    fraction = False
+    slider_top = True
+    min_distance = 5
+