{"author":"John Garrett","author_email":"garrettj403@gmail.com","bugtrack_url":null,"classifiers":["Framework :: Matplotlib","License :: OSI Approved :: MIT License","Programming Language :: Python :: 3"],"description":"Science Plots\r\n=============\r\n\r\n> **Warning**\r\n> : As of version 2.0.0, you need to add `import scienceplots` before setting the style (`plt.style.use('science')`).\r\n\r\n[![PyPI version](https://badge.fury.io/py/SciencePlots.svg)](https://badge.fury.io/py/SciencePlots)\r\n[![DOI](https://zenodo.org/badge/144605189.svg)](https://zenodo.org/badge/latestdoi/144605189)\r\n\r\n*Matplotlib styles for scientific figures*\r\n\r\nThis repo has Matplotlib styles to format your figures for scientific papers, presentations and theses.\r\n\r\n

\r\n\r\n

\r\n\r\nYou can find [the full gallery of included styles here](https://github.com/garrettj403/SciencePlots/wiki/Gallery).\r\n\r\nGetting Started\r\n---------------\r\n\r\nThe easiest way to install SciencePlots is by using `pip`:\r\n\r\n```bash\r\n# to install the lastest release (from PyPI)\r\npip install SciencePlots\r\n\r\n# to install the latest commit (from GitHub)\r\npip install git+https://github.com/garrettj403/SciencePlots\r\n\r\n# to clone and install from a local copy\r\ngit clone https://github.com/garrettj403/SciencePlots.git\r\ncd SciencePlots\r\npip install -e .\r\n```\r\n\r\nFrom version `v1.1.0` on, `import scienceplots` is needed on top of your scripts so Matplotlib can make use of the styles.\r\n\r\n**Notes:** \r\n- SciencePlots requires Latex ([see Latex installation instructions](https://github.com/garrettj403/SciencePlots/wiki/FAQ#installing-latex)). \r\n- If you would like to use CJK fonts, you will need to install these font separately ([see CJK font installation instructions](https://github.com/garrettj403/SciencePlots/wiki/FAQ#installing-cjk-fonts)).\r\n\r\nPlease see the [FAQ](https://github.com/garrettj403/SciencePlots/wiki/FAQ) for more information and troubleshooting.\r\n\r\nUsing the Styles\r\n----------------\r\n\r\n``\"science\"`` is the primary style in this repo. Whenever you want to use it, simply add the following to the top of your python script:\r\n\r\n```python\r\nimport matplotlib.pyplot as plt\r\nimport scienceplots\r\n\r\nplt.style.use('science')\r\n```\r\n\r\nYou can also combine multiple styles together by:\r\n\r\n```python\r\nplt.style.use(['science','ieee'])\r\n```\r\n\r\nIn this case, the ``ieee`` style will override some of the parameters from the ``science`` style in order to configure the plot for IEEE papers (column width, fontsizes, etc.).\r\n\r\nTo use any of the styles temporarily, you can use:\r\n\r\n```python\r\nwith plt.style.context('science'):\r\n plt.figure()\r\n plt.plot(x, y)\r\n plt.show()\r\n```\r\n\r\nExamples\r\n--------\r\n\r\nThe basic ``science`` style is shown below:\r\n\r\n

\r\n\r\nIt can be cascaded with other styles to fine-tune the appearance. For example, the ``science`` + ``notebook`` styles (intended for Jupyter notebooks):\r\n\r\n

\r\n\r\nPlease see [the project Wiki](https://github.com/garrettj403/SciencePlots/wiki/Gallery) for a full list of available styles.\r\n\r\nSpecific Styles for Academic Journals\r\n-------------------------------------\r\n\r\nThe ``science`` + ``ieee`` styles for IEEE papers:\r\n\r\n

\r\n\r\n - IEEE requires figures to be readable when printed in black and white. The ``ieee`` style also sets the figure width to fit within one column of an IEEE paper.\r\n\r\nThe ``science`` + ``nature`` styles for Nature articles:\r\n\r\n

\r\n\r\n - Nature recommends sans-serif fonts.\r\n\r\nOther languages\r\n---------------\r\n\r\nSciencePlots currently supports:\r\n * [Traditional Chinese](https://github.com/garrettj403/SciencePlots/wiki/Gallery#traditional-chinese)\r\n * [Simplified Chinese](https://github.com/garrettj403/SciencePlots/wiki/Gallery#simplified-chinese)\r\n * [Japanese](https://github.com/garrettj403/SciencePlots/wiki/Gallery#japanese)\r\n * [Korean](https://github.com/garrettj403/SciencePlots/wiki/Gallery#korean)\r\n * [Russian](https://github.com/garrettj403/SciencePlots/wiki/Gallery#russian)\r\n * [Turkish](https://github.com/garrettj403/SciencePlots/wiki/Gallery#turkish)\r\n\r\nExample: Traditional Chinese (`science` + `no-latex` + `cjk-tc-font`):\r\n\r\n

\r\n\r\nSee the [FAQ](https://github.com/garrettj403/SciencePlots/wiki/FAQ#installing-cjk-fonts) for information on installing CJK fonts.\r\n\r\nOther color cycles\r\n------------------\r\n\r\nSciencePlots comes with a variety of different color cycles. For a full list, [see the project Wiki](https://github.com/garrettj403/SciencePlots/wiki/Gallery#color-cycles). Two examples are shown below.\r\n\r\nThe ``bright`` color cycle (color blind safe):\r\n\r\n

\r\n\r\nThe ``high-vis`` color cycle:\r\n\r\n

\r\n\r\nHelp and Contributing\r\n---------------------\r\n\r\nPlease feel free to contribute to the SciencePlots repo! For example, it would be good to add new styles for different journals and add new color cycles. Before starting a new style or making any changes, please create an issue through the [GitHub issue tracker](https://github.com/garrettj403/SciencePlots/issues). That way we can discuss if the changes are necessary and the best approach.\r\n\r\nIf you need any help with SciencePlots, please first check the [FAQ](https://github.com/garrettj403/SciencePlots/wiki/FAQ) and search through the [previous GitHub issues](https://github.com/garrettj403/SciencePlots/issues). If you can't find an answer, create a new issue through the [GitHub issue tracker](https://github.com/garrettj403/SciencePlots/issues).\r\n\r\nYou can checkout [Matplotlib's documentation](https://matplotlib.org/tutorials/introductory/customizing.html) for more information on plotting settings.\r\n\r\nFAQ\r\n---\r\n\r\nYou can find [the FAQ in the project Wiki.](https://github.com/garrettj403/SciencePlots/wiki/FAQ)\r\n\r\nSciencePlots in Academic Papers\r\n-------------------------------\r\n\r\nThe following papers use ``SciencePlots``:\r\n\r\n- J. D. Garrett, C.-Y. E. Tong, L. Zeng, T.-J. Chen and M.-J. Wang, [\"A 345 GHz Sideband-Separating Receiver Prototype with Ultra-Wide Instantaneous Bandwidth,\"](https://ieeexplore.ieee.org/document/10089556) *IEEE Trans. THz Sci. Technol.*, vol. 13, no. 3, pp. 237-245, Mar. 2023.\r\n\r\n- J. Garrett, B.-K. Tan, C. Chaumont, F. Boussaha, and G. Yassin, [\"A 230-GHz Endfire SIS Mixer With Near Quantum-Limited Performance,\"](https://ieeexplore.ieee.org/document/9833810) *IEEE Microw. Wirel. Compon. Lett.*, Jul. 2022. ([open access](https://ora.ox.ac.uk/objects/uuid:59a100bf-c997-499a-be20-01fc66fffe2b))\r\n\r\n- J. Garrett, and E. Tong, [\"Measuring Cryogenic Waveguide Loss in the Terahertz Regime,\"](https://ieeexplore.ieee.org/document/9727077) *IEEE Trans. THz Sci. Technol.*, vol. 12, no. 3, pp. 293-299, May 2022.\r\n\r\n- Y. Liu, X. Liu, and Y. Sun, [\"QGrain: An open-source and easy-to-use software for the comprehensive analysis of grain size distributions\"](https://doi.org/10.1016/j.sedgeo.2021.105980), *Sedimentary Geology*, vol. 423, 105980, Aug. 2021.\r\n\r\n- M. Gasanov, *et al.*, [\"A New Multi-objective Approach to Optimize Irrigation Using a Crop Simulation Model and Weather History\"](https://link.springer.com/chapter/10.1007/978-3-030-77970-2_7) in *Computational Science–ICCS 2021*, Krakow, Poland, Jun. 2021, pp. 75-88. ([open access](https://www.researchgate.net/profile/Sergey-Matveev-5/publication/352285985_A_New_Multi-objective_Approach_to_Optimize_Irrigation_Using_a_Crop_Simulation_Model_and_Weather_History/links/60e74b88b8c0d5588ce2da07/A-New-Multi-objective-Approach-to-Optimize-Irrigation-Using-a-Crop-Simulation-Model-and-Weather-History.pdf))\r\n\r\n- J. Garrett, and E. Tong, [\"A Dispersion-Compensated Algorithm for the Analysis of Electromagnetic Waveguides,\"](https://ieeexplore.ieee.org/document/9447194) *IEEE Signal Process. Lett.*, vol. 28, pp. 1175-1179, Jun. 2021.\r\n\r\n- G. Jegannathan, *et al.*, [\"Current-Assisted SPAD with Improved p-n Junction and Enhanced NIR Performance\"](https://www.mdpi.com/1424-8220/20/24/7105), *Sensors*, Dec 2020. ([open access](https://www.mdpi.com/1424-8220/20/24/7105))\r\n\r\n- H. Tian, *et al.*, [\"ivis Dimensionality Reduction Framework for Biomacromolecular Simulations\"](https://pubs.acs.org/doi/abs/10.1021/acs.jcim.0c00485), *J. Chem. Inf. Model.*, Aug 2020. ([open access](https://arxiv.org/pdf/2004.10718.pdf))\r\n\r\n- P. Stoltz, *et al.*, [\"A new simple algorithm for space charge limited emission,\"](https://aip.scitation.org/doi/10.1063/5.0020781) *Phys. Plasmas*, vol. 27, no. 9, pp. 093103, Sep. 2020. ([open access](https://aip.scitation.org/doi/10.1063/5.0020781))\r\n\r\n- J. Garrett, *et al.*, [\"A Nonlinear Transmission Line Model for Simulating Distributed SIS Frequency Multipliers,\"](https://ieeexplore.ieee.org/abstract/document/9050728) *IEEE Trans. THz Sci. Technol.*, vol. 10, no. 3, pp. 246-255, May 2020. ([open access](https://ora.ox.ac.uk/objects/uuid:5ca31c2c-a984-462c-b21a-3fe16eee0d9b/download_file?safe_filename=XXXX_final_JohnGarrett.pdf&type_of_work=Journal+article))\r\n\r\n- J. Garrett, *et al.*, [\"Simulating the Behavior of a 230 GHz SIS Mixer Using Multi-Tone Spectral Domain Analysis,\"](https://ieeexplore.ieee.org/document/8822760/) *IEEE Trans. THz Sci. Technol.*, vol. 9, no. 9, pp. 540-548, Nov. 2019. ([open access](https://ora.ox.ac.uk/objects/uuid:0fd4537d-258c-454a-bbfb-09b1bcd88d49/download_file?file_format=pdf&safe_filename=XXXX_final.pdf&type_of_work=Journal+article))\r\n\r\n- J. Garrett, *et al.*, [\"A Compact and Easy to Fabricate E-plane Waveguide Bend,\"](https://ieeexplore.ieee.org/document/8760521) *IEEE Microw. Wireless Compon. Lett.*, vol. 29, no. 8, pp. 529-531, Aug. 2019. ([open access](https://ora.ox.ac.uk/objects/uuid:496855f9-be2a-47cd-b498-1753d8033f50/download_file?file_format=pdf&safe_filename=Waveguide_Bend__IEEE_MWCL_.pdf&type_of_work=Journal+article))\r\n\r\n- J. Garrett, [\"A 230 GHz Focal Plane Array Using a Wide IF Bandwidth SIS Receiver,\"](https://ora.ox.ac.uk/objects/uuid:d47fbf3b-1cf3-4e58-be97-767b9893066e/download_file?file_format=pdf&safe_filename=GarrettJ_DPhilThesis.pdf&type_of_work=Thesis) DPhil thesis, University of Oxford, Oxford, UK, 2018. ([open access](https://ora.ox.ac.uk/objects/uuid:d47fbf3b-1cf3-4e58-be97-767b9893066e/download_file?file_format=pdf&safe_filename=GarrettJ_DPhilThesis.pdf&type_of_work=Thesis))\r\n\r\nIf you use ``SciencePlots`` in your paper/thesis, feel free to add it to the list!\r\n\r\nCiting SciencePlots\r\n-------------------\r\n\r\nYou don't have to cite SciencePlots if you use it but it's nice if you do:\r\n\r\n @article{SciencePlots,\r\n author = {John D. Garrett},\r\n title = {{garrettj403/SciencePlots}},\r\n month = sep,\r\n year = 2021,\r\n publisher = {Zenodo},\r\n version = {1.0.9},\r\n doi = {10.5281/zenodo.4106649},\r\n url = {http://doi.org/10.5281/zenodo.4106649}\r\n }\r\n","description_content_type":"text/markdown","docs_url":null,"download_url":"","downloads":{"last_day":-1,"last_month":-1,"last_week":-1},"dynamic":null,"home_page":"https://github.com/garrettj403/SciencePlots/","keywords":"matplotlib-style-sheets,matplotlib-figures,scientific-papers,thesis-template,matplotlib-styles,python","license":"MIT","license_expression":null,"license_files":null,"maintainer":"Echedey Luis","maintainer_email":"echelual@gmail.com","name":"SciencePlots","package_url":"https://pypi.org/project/SciencePlots/","platform":null,"project_url":"https://pypi.org/project/SciencePlots/","project_urls":{"Homepage":"https://github.com/garrettj403/SciencePlots/"},"provides_extra":null,"release_url":"https://pypi.org/project/SciencePlots/2.1.1/","requires_dist":["matplotlib"],"requires_python":"","summary":"Format Matplotlib for scientific plotting","version":"2.1.1","yanked":false,"yanked_reason":null}

Package search

SciencePlots

project_urls

Dependencies

All package metadata

Releases