diplotocus 0.3.6__tar.gz → 0.4.2__tar.gz

{diplotocus-0.3.6 → diplotocus-0.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: diplotocus
-Version: 0.3.6
+Version: 0.4.2
 Summary: A python package to generate animations of matplotlib objects.
 Author-email: Tristan Boin <tristan.boin@obspm.fr>
 License-Expression: MIT

{diplotocus-0.3.6 → diplotocus-0.4.2}/docs/requirements.txt

@@ -5,4 +5,5 @@ sphinx-autodoc-typehints
 matplotlib
 numpy
 svgpath2mpl
-sphinx-copybutton
+sphinx-copybutton
+sphinx_design

{diplotocus-0.3.6 → diplotocus-0.4.2}/docs/source/conf.py

@@ -52,7 +52,8 @@ extensions = [
     "sphinx.ext.linkcode",
     "sphinx.ext.intersphinx",
     "sphinx_autodoc_typehints",
-    "sphinx_copybutton"
+    "sphinx_copybutton",
+    "sphinx_design"
 ]
 
 intersphinx_mapping = {
@@ -65,7 +66,7 @@ myst_all_links_external = True
 templates_path = ['_templates']
 # exclude specific generated/unused notebooks to avoid spurious warnings
 exclude_patterns = [
-    'notebooks/logo.ipynb','notebooks/index.ipynb'
+    'notebooks/index.ipynb'
 ]
 
 html_favicon = "_static/favicon.ico"
@@ -93,6 +94,7 @@ html_js_files = [
 myst_enable_extensions = [
     "html_image",
     "dollarmath",
+    "colon_fence"
 ]
 
 nb_execution_allow_errors = True

{diplotocus-0.3.6 → diplotocus-0.4.2}/docs/source/index.rst

@@ -59,9 +59,10 @@ Here's a quick example of the syntax of diplotocus:
 
 .. image:: _static/Web_GUI.png
    :width: 700
-   :target: notebooks/GUI
+   :target: notebooks/GUI.html
 
 Get started by :doc:`Installing Diplotocus <notebooks/installation>`, and follow the :doc:`Quick-Start guide <notebooks/quick-start>`.
+For examples, see the :doc:`Examples <notebooks/examples>` page.
 
 .. toctree::
    :maxdepth: 2
@@ -71,7 +72,7 @@ Get started by :doc:`Installing Diplotocus <notebooks/installation>`, and follow
    notebooks/quick-start
 
 .. toctree::
-   :maxdepth: 3
+   :maxdepth: 2
    :caption: Library reference
    
    notebooks/timeline
@@ -80,6 +81,7 @@ Get started by :doc:`Installing Diplotocus <notebooks/installation>`, and follow
    notebooks/easings
    notebooks/projects
    notebooks/GUI
+   notebooks/examples
 
 .. toctree::
    :maxdepth: 2

{diplotocus-0.3.6 → diplotocus-0.4.2}/docs/source/notebooks/animations.ipynb

@@ -60,7 +60,7 @@
     {
      "data": {
       "text/markdown": [
-       "Saved video ../_static/anim_translate.mp4"
+       "Saved video ../_static/animations/anim_translate.mp4"
       ],
       "text/plain": [
        "<IPython.core.display.Markdown object>"
@@ -74,7 +74,7 @@
       "text/html": [
        "\n",
        "                <video width=\"640\" height=\"360\" autoplay loop muted playsinline>\n",
-       "                <source src=\"../_static/anim_translate.mp4?randId=449\" type=\"video/mp4\">\n",
+       "                <source src=\"../_static/animations/anim_translate.mp4?randId=449\" type=\"video/mp4\">\n",
        "                </video>\n",
        "            "
       ],
@@ -98,7 +98,7 @@
     "p.translate(start_pos=(0,0),end_pos=(1,1),duration=60)\n",
     "\n",
     "tl.animate(p)\n",
-    "tl.save_video('../_static/anim_translate.mp4')"
+    "tl.save_video('../_static/animations/anim_translate.mp4')"
    ]
   },
   {
@@ -137,7 +137,7 @@
     {
      "data": {
       "text/markdown": [
-       "Saved video ../_static/anim_rotate.mp4"
+       "Saved video ../_static/animations/anim_rotate.mp4"
       ],
       "text/plain": [
        "<IPython.core.display.Markdown object>"
@@ -151,7 +151,7 @@
       "text/html": [
        "\n",
        "                <video width=\"640\" height=\"360\" autoplay loop muted playsinline>\n",
-       "                <source src=\"../_static/anim_rotate.mp4?randId=1017\" type=\"video/mp4\">\n",
+       "                <source src=\"../_static/animations/anim_rotate.mp4?randId=1017\" type=\"video/mp4\">\n",
        "                </video>\n",
        "            "
       ],
@@ -175,7 +175,7 @@
     "p.rotate(start_angle=20,end_angle=110,duration=60)\n",
     "\n",
     "tl.animate(p)\n",
-    "tl.save_video('../_static/anim_rotate.mp4')"
+    "tl.save_video('../_static/animations/anim_rotate.mp4')"
    ]
   },
   {
@@ -214,7 +214,7 @@
     {
      "data": {
       "text/markdown": [
-       "Saved video ../_static/anim_scale.mp4"
+       "Saved video ../_static/animations/anim_scale.mp4"
       ],
       "text/plain": [
        "<IPython.core.display.Markdown object>"
@@ -228,7 +228,7 @@
       "text/html": [
        "\n",
        "                <video width=\"640\" height=\"360\" autoplay loop muted playsinline>\n",
-       "                <source src=\"../_static/anim_scale.mp4?randId=2110\" type=\"video/mp4\">\n",
+       "                <source src=\"../_static/animations/anim_scale.mp4?randId=2110\" type=\"video/mp4\">\n",
        "                </video>\n",
        "            "
       ],
@@ -252,7 +252,7 @@
     "p.scale(start_scale=(0,1),end_scale=(2,0),duration=60)\n",
     "\n",
     "tl.animate(p)\n",
-    "tl.save_video('../_static/anim_scale.mp4')"
+    "tl.save_video('../_static/animations/anim_scale.mp4')"
    ]
   },
   {
@@ -303,7 +303,7 @@
     {
      "data": {
       "text/markdown": [
-       "Saved video ../_static/anim_tween.mp4"
+       "Saved video ../_static/animations/anim_tween.mp4"
       ],
       "text/plain": [
        "<IPython.core.display.Markdown object>"
@@ -317,7 +317,7 @@
       "text/html": [
        "\n",
        "                <video width=\"640\" height=\"360\" autoplay loop muted playsinline>\n",
-       "                <source src=\"../_static/anim_tween.mp4?randId=9568\" type=\"video/mp4\">\n",
+       "                <source src=\"../_static/animations/anim_tween.mp4?randId=9568\" type=\"video/mp4\">\n",
        "                </video>\n",
        "            "
       ],
@@ -341,7 +341,85 @@
     "p.tween(property='c',start='red',end='green',duration=60)\n",
     "\n",
     "tl.animate(p)\n",
-    "tl.save_video('../_static/anim_tween.mp4')"
+    "tl.save_video('../_static/animations/anim_tween.mp4')"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "e0ff28d9",
+   "metadata": {},
+   "source": [
+    "### Math\n",
+    "\n",
+    "```{eval-rst}\n",
+    ".. automethod:: diplotocus.animations.plotObject.math\n",
+    "    :noindex:\n",
+    "```"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "id": "80466fb9",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "fb4cddf752e64c119b865c846a9b4041",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "  0%|          | 0/60 [00:00<?, ?it/s]"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/markdown": [
+       "Saved video ../_static/animations/anim_math.mp4"
+      ],
+      "text/plain": [
+       "<IPython.core.display.Markdown object>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "\n",
+       "                <video width=\"640\" height=\"360\" autoplay loop muted playsinline>\n",
+       "                <source src=\"../_static/animations/anim_math.mp4?randId=508\" type=\"video/mp4\">\n",
+       "                </video>\n",
+       "            "
+      ],
+      "text/plain": [
+       "<IPython.core.display.HTML object>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "import diplotocus as dpl\n",
+    "import numpy as np\n",
+    "\n",
+    "x = [-1,1,0,-1]\n",
+    "y = [-1,-1,1,-1]\n",
+    "\n",
+    "tl = dpl.Timeline(xlim=(-2.5,2.5),ylim=(-2,2))\n",
+    "\n",
+    "p = dpl.plot(x=x,y=y)\n",
+    "p.math(property='lw',func=lambda t:np.cos(t*6*np.pi)*20+3,duration=60)\n",
+    "\n",
+    "tl.animate(p)\n",
+    "tl.save_video('../_static/animations/anim_math.mp4')"
    ]
   },
   {
@@ -380,7 +458,7 @@
     {
      "data": {
       "text/markdown": [
-       "Saved video ../_static/anim_morph.mp4"
+       "Saved video ../_static/animations/anim_morph.mp4"
       ],
       "text/plain": [
        "<IPython.core.display.Markdown object>"
@@ -394,7 +472,7 @@
       "text/html": [
        "\n",
        "                <video width=\"640\" height=\"360\" autoplay loop muted playsinline>\n",
-       "                <source src=\"../_static/anim_morph.mp4?randId=1825\" type=\"video/mp4\">\n",
+       "                <source src=\"../_static/animations/anim_morph.mp4?randId=1825\" type=\"video/mp4\">\n",
        "                </video>\n",
        "            "
       ],
@@ -422,7 +500,7 @@
     "p.morph(new_x=x2,new_y=y2,duration=60)\n",
     "\n",
     "tl.animate(p)\n",
-    "tl.save_video('../_static/anim_morph.mp4')"
+    "tl.save_video('../_static/animations/anim_morph.mp4')"
    ]
   },
   {
@@ -461,7 +539,7 @@
     {
      "data": {
       "text/markdown": [
-       "Saved video ../_static/anim_draw.mp4"
+       "Saved video ../_static/animations/anim_draw.mp4"
       ],
       "text/plain": [
        "<IPython.core.display.Markdown object>"
@@ -475,7 +553,7 @@
       "text/html": [
        "\n",
        "                <video width=\"640\" height=\"360\" autoplay loop muted playsinline>\n",
-       "                <source src=\"../_static/anim_draw.mp4?randId=6085\" type=\"video/mp4\">\n",
+       "                <source src=\"../_static/animations/anim_draw.mp4?randId=6085\" type=\"video/mp4\">\n",
        "                </video>\n",
        "            "
       ],
@@ -500,7 +578,7 @@
     "p.draw(duration=60)\n",
     "\n",
     "tl.animate(p)\n",
-    "tl.save_video('../_static/anim_draw.mp4')"
+    "tl.save_video('../_static/animations/anim_draw.mp4')"
    ]
   },
   {
@@ -539,7 +617,7 @@
     {
      "data": {
       "text/markdown": [
-       "Saved video ../_static/anim_sequence.mp4"
+       "Saved video ../_static/animations/anim_sequence.mp4"
       ],
       "text/plain": [
        "<IPython.core.display.Markdown object>"
@@ -553,7 +631,7 @@
       "text/html": [
        "\n",
        "                <video width=\"640\" height=\"360\" autoplay loop muted playsinline>\n",
-       "                <source src=\"../_static/anim_sequence.mp4?randId=1390\" type=\"video/mp4\">\n",
+       "                <source src=\"../_static/animations/anim_sequence.mp4?randId=1390\" type=\"video/mp4\">\n",
        "                </video>\n",
        "            "
       ],
@@ -580,7 +658,7 @@
     "p.sequence(duration=50)\n",
     "\n",
     "tl.animate(p)\n",
-    "tl.save_video('../_static/anim_sequence.mp4')"
+    "tl.save_video('../_static/animations/anim_sequence.mp4')"
    ]
   },
   {
@@ -621,7 +699,7 @@
     {
      "data": {
       "text/markdown": [
-       "Saved video ../_static/axis_zoom.mp4"
+       "Saved video ../_static/animations/axis_zoom.mp4"
       ],
       "text/plain": [
        "<IPython.core.display.Markdown object>"
@@ -635,7 +713,7 @@
       "text/html": [
        "\n",
        "                <video width=\"640\" height=\"360\" autoplay loop muted playsinline>\n",
-       "                <source src=\"../_static/axis_zoom.mp4?randId=9285\" type=\"video/mp4\">\n",
+       "                <source src=\"../_static/animations/axis_zoom.mp4?randId=9285\" type=\"video/mp4\">\n",
        "                </video>\n",
        "            "
       ],
@@ -659,7 +737,7 @@
     "a = dpl.axis_zoom(zoom=2,duration=60)\n",
     "\n",
     "tl.animate(a)\n",
-    "tl.save_video('../_static/axis_zoom.mp4')"
+    "tl.save_video('../_static/animations/axis_zoom.mp4')"
    ]
   },
   {
@@ -698,7 +776,7 @@
     {
      "data": {
       "text/markdown": [
-       "Saved video ../_static/axis_limits.mp4"
+       "Saved video ../_static/animations/axis_limits.mp4"
       ],
       "text/plain": [
        "<IPython.core.display.Markdown object>"
@@ -712,7 +790,7 @@
       "text/html": [
        "\n",
        "                <video width=\"640\" height=\"360\" autoplay loop muted playsinline>\n",
-       "                <source src=\"../_static/axis_limits.mp4?randId=2059\" type=\"video/mp4\">\n",
+       "                <source src=\"../_static/animations/axis_limits.mp4?randId=2059\" type=\"video/mp4\">\n",
        "                </video>\n",
        "            "
       ],
@@ -736,7 +814,7 @@
     "a = dpl.axis_limits(xlim=(-5,5),ylim=(-1,1),duration=60)\n",
     "\n",
     "tl.animate(a)\n",
-    "tl.save_video('../_static/axis_limits.mp4')"
+    "tl.save_video('../_static/animations/axis_limits.mp4')"
    ]
   },
   {
@@ -775,7 +853,7 @@
     {
      "data": {
       "text/markdown": [
-       "Saved video ../_static/axis_move.mp4"
+       "Saved video ../_static/animations/axis_move.mp4"
       ],
       "text/plain": [
        "<IPython.core.display.Markdown object>"
@@ -789,7 +867,7 @@
       "text/html": [
        "\n",
        "                <video width=\"640\" height=\"360\" autoplay loop muted playsinline>\n",
-       "                <source src=\"../_static/axis_move.mp4?randId=7288\" type=\"video/mp4\">\n",
+       "                <source src=\"../_static/animations/axis_move.mp4?randId=7288\" type=\"video/mp4\">\n",
        "                </video>\n",
        "            "
       ],
@@ -813,7 +891,7 @@
     "a = dpl.axis_move(end_pos=(1,1),duration=60)\n",
     "\n",
     "tl.animate(a)\n",
-    "tl.save_video('../_static/axis_move.mp4')"
+    "tl.save_video('../_static/animations/axis_move.mp4')"
    ]
   },
   {
@@ -852,7 +930,7 @@
     {
      "data": {
       "text/markdown": [
-       "Saved video ../_static/axis_alpha.mp4"
+       "Saved video ../_static/animations/axis_alpha.mp4"
       ],
       "text/plain": [
        "<IPython.core.display.Markdown object>"
@@ -866,7 +944,7 @@
       "text/html": [
        "\n",
        "                <video width=\"640\" height=\"360\" autoplay loop muted playsinline>\n",
-       "                <source src=\"../_static/axis_alpha.mp4?randId=3022\" type=\"video/mp4\">\n",
+       "                <source src=\"../_static/animations/axis_alpha.mp4?randId=3022\" type=\"video/mp4\">\n",
        "                </video>\n",
        "            "
       ],
@@ -890,7 +968,7 @@
     "a = dpl.axis_alpha(start_alpha=0,end_alpha=1,duration=50)\n",
     "\n",
     "tl.animate(a)\n",
-    "tl.save_video('../_static/axis_alpha.mp4')"
+    "tl.save_video('../_static/animations/axis_alpha.mp4')"
    ]
   },
   {
@@ -929,7 +1007,7 @@
     {
      "data": {
       "text/markdown": [
-       "Saved video ../_static/fig_width_ratio.mp4"
+       "Saved video ../_static/animations/fig_width_ratio.mp4"
       ],
       "text/plain": [
        "<IPython.core.display.Markdown object>"
@@ -943,7 +1021,7 @@
       "text/html": [
        "\n",
        "                <video width=\"640\" height=\"360\" autoplay loop muted playsinline>\n",
-       "                <source src=\"../_static/fig_width_ratio.mp4?randId=4844\" type=\"video/mp4\">\n",
+       "                <source src=\"../_static/animations/fig_width_ratio.mp4?randId=4844\" type=\"video/mp4\">\n",
        "                </video>\n",
        "            "
       ],
@@ -970,7 +1048,7 @@
     "a = dpl.fig_width_ratio(start_widths=(1,0),end_widths=(0,1),duration=60)\n",
     "\n",
     "tl.animate(a)\n",
-    "tl.save_video('../_static/fig_width_ratio.mp4')"
+    "tl.save_video('../_static/animations/fig_width_ratio.mp4')"
    ]
   },
   {
@@ -1009,7 +1087,7 @@
     {
      "data": {
       "text/markdown": [
-       "Saved video ../_static/fig_height_ratio.mp4"
+       "Saved video ../_static/animations/fig_height_ratio.mp4"
       ],
       "text/plain": [
        "<IPython.core.display.Markdown object>"
@@ -1023,7 +1101,7 @@
       "text/html": [
        "\n",
        "                <video width=\"640\" height=\"360\" autoplay loop muted playsinline>\n",
-       "                <source src=\"../_static/fig_height_ratio.mp4?randId=767\" type=\"video/mp4\">\n",
+       "                <source src=\"../_static/animations/fig_height_ratio.mp4?randId=767\" type=\"video/mp4\">\n",
        "                </video>\n",
        "            "
       ],
@@ -1050,7 +1128,7 @@
     "a = dpl.fig_height_ratio(start_heights=(1,0),end_heights=(0,1),duration=60)\n",
     "\n",
     "tl.animate(a)\n",
-    "tl.save_video('../_static/fig_height_ratio.mp4')"
+    "tl.save_video('../_static/animations/fig_height_ratio.mp4')"
    ]
   }
  ],