{"id":3249,"library":"python-nvd3","title":"Python NVD3","description":"Python NVD3 is a Python wrapper for the NVD3 JavaScript library, which in turn builds re-usable charts and chart components for d3.js. It enables Python developers to generate interactive D3.js charts by writing Python code. The current version, 0.16.0, was uploaded to PyPI in April 2024. While receiving recent maintenance uploads, major feature development largely concluded around 2015, indicating a maintenance-focused release cadence.","status":"maintenance","version":"0.16.0","language":"en","source_language":"en","source_url":"https://github.com/areski/python-nvd3","tags":["charting","data visualization","d3.js","nvd3","python","javascript"],"install":[{"cmd":"pip install python-nvd3","lang":"bash","label":"Install latest version"}],"dependencies":[{"reason":"Used for generating URL-friendly slugs for chart names/IDs.","package":"python-slugify","optional":false},{"reason":"Used for rendering the JavaScript and HTML templates for the charts.","package":"jinja2","optional":false},{"reason":"The core JavaScript library for data visualization, required at runtime in the browser for charts to render. Needs to be served separately (e.g., via CDN or local files).","package":"d3.js","optional":false},{"reason":"The JavaScript charting library built on D3.js, required at runtime in the browser for charts to render. Needs to be served separately.","package":"nvd3.js","optional":false},{"reason":"Historically recommended for managing D3.js and NVD3.js JavaScript dependencies, though not strictly mandatory if JS files are managed otherwise.","package":"bower","optional":true}],"imports":[{"symbol":"pieChart","correct":"from nvd3 import pieChart"},{"symbol":"lineChart","correct":"from nvd3 import lineChart"},{"symbol":"multiBarChart","correct":"from nvd3 import multiBarChart"}],"quickstart":{"code":"from nvd3 import pieChart\n\n# Prepare data\nxdata = [\"Orange\", \"Banana\", \"Pear\", \"Kiwi\", \"Apple\", \"Strawberry\", \"Pineapple\"]\nydata = [3, 4, 0, 1, 5, 7, 3]\n\n# Create a pie chart\nchart_name = 'pieChart'\nchart = pieChart(name=chart_name, color_category='category20c', height=450, width=450)\n\n# Add a series of data\nextra_serie = {\"tooltip\": {\"y_start\": \"\", \"y_end\": \" cal\"}}\nchart.add_serie(y=ydata, x=xdata, extra=extra_serie)\n\n# Build the HTML content\nchart.buildcontent()\n\n# The generated HTML can be saved to a file or embedded in a web application\nhtml_output = f\"\"\"\n\n\n\n NVD3 Pie Chart\n \n \n \n \n \n \n\n\n
{chart_name}
\n {chart.htmlcontent}\n\n\n\"\"\"\n\n# In a real application, you might pass this 'html_output' to a web framework template.\nprint(html_output)\n\n# To demonstrate the generated chart in a browser, uncomment the following:\n# with open('my_pie_chart.html', 'w') as f:\n# f.write(html_output)\n# import webbrowser\n# webbrowser.open('my_pie_chart.html')","lang":"python","description":"This quickstart demonstrates how to create a basic pie chart using `python-nvd3`. It initializes a `pieChart` object, adds data, builds the HTML and JavaScript content, and shows how to generate a complete HTML file ready for rendering in a web browser. Note that D3.js and NVD3.js JavaScript libraries, along with their CSS, must be included externally for the chart to render properly."},"warnings":[{"fix":"Include `