{ "cells": [ { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "# Parcels Tutorial" ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "Welcome to a quick tutorial on Parcels. This is meant to get you started with the code, and give you a flavour of some of the key features of Parcels." ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "In this tutorial, we will first cover how to run a set of particles [from a very simple idealised field](#Running-particles-in-an-idealised-field). We will show how easy it is to run particles in [time-backward mode](#Running-particles-in-backward-time). Then, we will show how to [add custom behaviour](#Adding-a-custom-behaviour-kernel) to the particles. Then we will show how to [run particles in a set of NetCDF files from external data](#Reading-in-data-from-arbritrary-NetCDF-files). Then we will show how to use particles to [sample a field](#Sampling-a-Field-with-Particles) such as temperature or sea surface height. And finally, we will show how to [write a kernel that tracks the distance travelled by the particles](#A-second-example-kernel:-calculating-distance-travelled)." ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "Let's start with importing the relevant modules. The key ones are all in the `parcels` directory." ] }, { "cell_type": "code", "execution_count": 1, "metadata": { "collapsed": false, "deletable": true, "editable": true }, "outputs": [], "source": [ "from parcels import FieldSet, ParticleSet, Variable, JITParticle, AdvectionRK4, plotTrajectoriesFile\n", "import numpy as np\n", "import math\n", "from datetime import timedelta\n", "from operator import attrgetter" ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "## Running particles in an idealised field" ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "The first step to running particles with Parcels is to define a `FieldSet` object, which is simply a collection of hydrodynamic fields. In this first case, we use a simple flow of two idealised moving eddies. That field is saved in NetCDF format in the directory `examples/MovingEddies_data`. Since we know that the files are in what's called `Parcels FieldSet` format, we can call these files using the function `FieldSet.from_parcels()`." ] }, { "cell_type": "code", "execution_count": 2, "metadata": { "collapsed": false, "deletable": true, "editable": true }, "outputs": [], "source": [ "fieldset = FieldSet.from_parcels(\"MovingEddies_data/moving_eddies\")" ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "The `fieldset` can then be visualised with the `show()` function. To plot an animation of the zonal velocity (`U`), give the following command" ] }, { "cell_type": "code", "execution_count": 3, "metadata": { "collapsed": false, "deletable": true, "editable": true }, "outputs": [ { "data": { "text/html": [ "" ], "text/plain": [ "" ] }, "execution_count": 3, "metadata": {}, "output_type": "execute_result" } ], "source": [ "fieldset.U.show(animation=True)" ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "The next step is to define a `ParticleSet`. In this case, we start 2 particles at (3.3E, 46N) and (3.3E, 47.8N) using the `from_list` constructor method, that are advected on the `fieldset` we defined above. Note that we use `JITParticle` as `pclass`, because we will be executing the advection in JIT (Just-In-Time) mode. The alternative is to run in `scipy` mode, in which case `pclass` is `ScipyParticle`" ] }, { "cell_type": "code", "execution_count": 4, "metadata": { "collapsed": true, "deletable": true, "editable": true }, "outputs": [], "source": [ "pset = ParticleSet.from_list(fieldset=fieldset, # the fields on which the particles are advected\n", " pclass=JITParticle, # the type of particles (JITParticle or ScipyParticle)\n", " lon=[ 3.3, 3.3], # a vector of release longitudes \n", " lat=[46.0, 47.8]) # a vector of release latitudes" ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "Print the `ParticleSet` to see where they start" ] }, { "cell_type": "code", "execution_count": 5, "metadata": { "collapsed": false, "deletable": true, "editable": true }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "P[0](lon=3.300000, lat=46.000000, depth=0.000000, time=not_yet_set)\n", "P[1](lon=3.300000, lat=47.799999, depth=0.000000, time=not_yet_set)\n" ] } ], "source": [ "print(pset)" ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "This output shows for each particle the (longitude, latitude, depth, time). Note that in this case the time is `not_yet_set`, that is because we didn't specify a `time` when we defined the `pset`." ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "To plot the positions of these particles on the zonal velocity, use the following command" ] }, { "cell_type": "code", "execution_count": 6, "metadata": { "collapsed": false, "deletable": true, "editable": true }, "outputs": [ { "data": { "image/png": "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\n", "text/plain": [ "" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "pset.show(field=fieldset.U)" ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "The final step is to run (or 'execute') the `ParticelSet`. We run the particles using the `AdvectionRK4` kernel, which is a 4th order Runge-Kutte implementation that comes with Parcels. We run the particles for 6 days (using the `timedelta` function from `datetime`), at an RK4 timestep of 5 minutes. We store the trajectory information at an interval of 1 hour in a file called `EddyParticles.nc`. Because `time` was `not_yet_set`, the particles will be advected from the first date available in the `fieldset`, which is the default behaviour." ] }, { "cell_type": "code", "execution_count": 7, "metadata": { "collapsed": false, "deletable": true, "editable": true }, "outputs": [ { "name": "stderr", "output_type": "stream", "text": [ "INFO: Compiled JITParticleAdvectionRK4 ==> /var/folders/r2/8593q8z93kd7t4j9kbb_f7p00000gn/T/parcels-501/218f0b1f004549f5b8077878203091fd.so\n" ] } ], "source": [ "pset.execute(AdvectionRK4, # the kernel (which defines how particles move)\n", " runtime=timedelta(days=6), # the total length of the run\n", " dt=timedelta(minutes=5), # the timestep of the kernel\n", " output_file=pset.ParticleFile(name=\"EddyParticles\", outputdt=timedelta(hours=1))) # the file name and the time step of the outputs" ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "The code should have run, which can be confirmed by printing and plotting the `ParticleSet` again" ] }, { "cell_type": "code", "execution_count": 8, "metadata": { "collapsed": false, "deletable": true, "editable": true }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "P[0](lon=2.024544, lat=46.088627, depth=0.000000, time=518400.000000)\n", "P[1](lon=2.017195, lat=48.305283, depth=0.000000, time=518400.000000)\n" ] }, { "data": { "image/png": "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\n/+DrGCBzJYkAAAAASUVORK5CYII=\n", "text/plain": [ "" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "print(pset)\n", "pset.show(field=fieldset.U)" ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "Note that both the particles (the black dots) and the `U` field have moved in the plot above. Also, the `time` of the particles is now 518400 seconds, which is 6 days." ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "The trajectory information of the particles is stored in the `EddyParticles.nc` file. It can be quickly plotted using the `plotTrajectoriesFile` function." ] }, { "cell_type": "code", "execution_count": 9, "metadata": { "collapsed": false, "deletable": true, "editable": true }, "outputs": [ { "data": { "image/png": "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\nrkJggg==\n", "text/plain": [ "" ] }, "metadata": {}, "output_type": "display_data" }, { "data": { "text/plain": [ "" ] }, "execution_count": 9, "metadata": {}, "output_type": "execute_result" } ], "source": [ "plotTrajectoriesFile('EddyParticles.nc')" ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "The `plotTrajectoriesFile` function can also be used to show the trajectories as an animation, by specifying that it has to run in `movie2d_notebook` mode. If we pass this to our function above, we can watch the particles go!" ] }, { "cell_type": "code", "execution_count": 10, "metadata": { "collapsed": false, "deletable": true, "editable": true }, "outputs": [ { "data": { "text/html": [ "" ], "text/plain": [ "" ] }, "execution_count": 10, "metadata": {}, "output_type": "execute_result" } ], "source": [ "plotTrajectoriesFile('EddyParticles.nc', mode='movie2d_notebook')" ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "Now one of the neat features of Parcels is that the particles can be plotted as a movie *during execution*, which is great for debugging. To rerun the particles while plotting them on top of the zonal velocity field (`fieldset.U`), first reinitialise the `ParticleSet` and then re-execute. However, now rather than saving the output to a file, display a movie using the `moviedt` display frequency, in this case with the zonal velocity `fieldset.U` as background" ] }, { "cell_type": "code", "execution_count": 11, "metadata": { "collapsed": true, "deletable": true, "editable": true }, "outputs": [], "source": [ "# THIS DOES NOT WORK IN THIS IPYTHON NOTEBOOK, BECAUSE OF THE INLINE PLOTTING.\n", "# THE 'SHOW_MOVIE' KEYWORD WILL WORK ON MOST MACHINES, THOUGH\n", "# pset = ParticleSet(fieldset=fieldset, size=2, pclass=JITParticle, lon=[3.3, 3.3], lat=[46.0, 47.8])\n", "# pset.execute(AdvectionRK4,\n", "# runtime=timedelta(days=6),\n", "# dt=timedelta(minutes=5),\n", "# moviedt=timedelta(hours=1),\n", "# movie_background_field=fieldset.U)" ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "## Running particles in backward time" ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "Running particles in backward time is extremely simple: just provide a `dt` < 0. " ] }, { "cell_type": "code", "execution_count": 12, "metadata": { "collapsed": false, "deletable": true, "editable": true }, "outputs": [], "source": [ "pset.execute(AdvectionRK4,\n", " dt=-timedelta(minutes=5), # negative timestep for backward run\n", " runtime=timedelta(days=0), # the run time\n", " output_file=pset.ParticleFile(name=\"EddyParticles_Bwd\", outputdt=timedelta(hours=1))) # the file name and the time step of the outputs" ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "Now print the particles again, and see that they (except for some round-off errors) returned to their original position" ] }, { "cell_type": "code", "execution_count": 13, "metadata": { "collapsed": false, "deletable": true, "editable": true }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "P[0](lon=3.299995, lat=45.999901, depth=0.000000, time=0.000000)\n", "P[1](lon=3.299851, lat=47.799862, depth=0.000000, time=0.000000)\n" ] }, { "data": { "image/png": "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\n", "text/plain": [ "" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "print(pset)\n", "pset.show(field=fieldset.U)" ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "## Adding a custom behaviour kernel" ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "A key feature of Parcels is the ability to quickly create very simple kernels, and add them to the execution. Kernels are little snippets of code that are run during exection of the particles." ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "In this example, we'll create a simple kernel where particles obtain an extra 2 m/s westward velocity after 1 day. Of course, this is not very realistic scenario, but it nicely illustrates the power of custom kernels." ] }, { "cell_type": "code", "execution_count": 14, "metadata": { "collapsed": false, "deletable": true, "editable": true }, "outputs": [], "source": [ "def WestVel(particle, fieldset, time, dt):\n", " if time > 86400:\n", " uvel = -2.\n", " particle.lon += uvel * dt / 1.1e5 # 1.1e5 m in 1 degree latitude" ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "Now reset the `ParticleSet` again, and re-execute. Note that we have now changed `kernel` to be `AdvectionRK4 + k_WestVel`, where `k_WestVel` is the `WestVel` function as defined above cast into a `Kernel` object (via the `pset.Kernel` call)." ] }, { "cell_type": "code", "execution_count": 15, "metadata": { "collapsed": false, "deletable": true, "editable": true }, "outputs": [ { "name": "stderr", "output_type": "stream", "text": [ "INFO: Compiled JITParticleAdvectionRK4WestVel ==> /var/folders/r2/8593q8z93kd7t4j9kbb_f7p00000gn/T/parcels-501/7aa5539cf1daebd20849333efa73afde.so\n" ] } ], "source": [ "pset = ParticleSet.from_list(fieldset=fieldset, pclass=JITParticle, lon=[3.3, 3.3], lat=[46.0, 47.8])\n", "\n", "k_WestVel = pset.Kernel(WestVel) # casting the WestVel function to a kernel object\n", "\n", "pset.execute(AdvectionRK4 + k_WestVel, # simply add kernels using the + operator\n", " runtime=timedelta(days=3),\n", " dt=timedelta(minutes=5),\n", " output_file=pset.ParticleFile(name=\"EddyParticles_WestVel\", outputdt=timedelta(hours=1)))" ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "And now plot this new trajectory file" ] }, { "cell_type": "code", "execution_count": 16, "metadata": { "collapsed": false, "deletable": true, "editable": true }, "outputs": [ { "data": { "image/png": "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\nSUVORK5CYII=\n", "text/plain": [ "" ] }, "metadata": {}, "output_type": "display_data" }, { "data": { "text/plain": [ "" ] }, "execution_count": 16, "metadata": {}, "output_type": "execute_result" } ], "source": [ "plotTrajectoriesFile('EddyParticles_WestVel.nc')" ] }, { "cell_type": "markdown", "metadata": { "collapsed": true, "deletable": true, "editable": true }, "source": [ "## Reading in data from arbritrary NetCDF files" ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "In most cases, you will want to advect particles within pre-computed velocity fields. If these velocity fields are stored in NetCDF format, it is fairly easy to load them into the `FieldSet.from_netcdf()` function." ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "The `examples` directory contains a set of [GlobCurrent](http://globcurrent.ifremer.fr/products-data/products-overview) files of the region around South Africa." ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "First, define the names of the files containing the zonal (U) and meridional (V) velocities. You can use wildcards (`*`) and the filenames for U and V can be the same (as in this case)" ] }, { "cell_type": "code", "execution_count": 17, "metadata": { "collapsed": false, "deletable": true, "editable": true }, "outputs": [], "source": [ "filenames = {'U': \"GlobCurrent_example_data/20*.nc\",\n", " 'V': \"GlobCurrent_example_data/20*.nc\"}" ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "Then, define a dictionary of the variables (`U` and `V`) and dimensions (`lon`, `lat` and `time`; note that in this case there is no `depth` because the GlobCurrent data is only for the surface of the ocean)" ] }, { "cell_type": "code", "execution_count": 18, "metadata": { "collapsed": false, "deletable": true, "editable": true }, "outputs": [], "source": [ "variables = {'U': 'eastward_eulerian_current_velocity',\n", " 'V': 'northward_eulerian_current_velocity'}\n", "dimensions = {'lat': 'lat',\n", " 'lon': 'lon',\n", " 'time': 'time'}" ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "Finally, read in the fieldset using the `FieldSet.from_netcdf` function with the above-defined `filenames`, `variables` and `dimensions`" ] }, { "cell_type": "code", "execution_count": 19, "metadata": { "collapsed": false, "deletable": true, "editable": true }, "outputs": [ { "name": "stderr", "output_type": "stream", "text": [ "WARNING: Casting lon data to np.float32\n", "WARNING: Casting lat data to np.float32\n", "WARNING: Casting depth data to np.float32\n" ] } ], "source": [ "fieldset = FieldSet.from_netcdf(filenames, variables, dimensions)" ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "Now define a `ParticleSet`, in this case with 5 particle starting on a line between (28E, 33S) and (30E, 33S) using the `ParticleSet.from_line` constructor method" ] }, { "cell_type": "code", "execution_count": 20, "metadata": { "collapsed": true, "deletable": true, "editable": true }, "outputs": [], "source": [ "pset = ParticleSet.from_line(fieldset=fieldset, pclass=JITParticle,\n", " size=5, # releasing 5 particles\n", " start=(28, -33), # releasing on a line: the start longitude and latitude\n", " finish=(30, -33)) # releasing on a line: the end longitude and latitude" ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "And finally execute the `ParticleSet` for 10 days using 4th order Runge-Kutta" ] }, { "cell_type": "code", "execution_count": 21, "metadata": { "collapsed": false, "deletable": true, "editable": true }, "outputs": [ { "name": "stderr", "output_type": "stream", "text": [ "INFO: Compiled JITParticleAdvectionRK4 ==> /var/folders/r2/8593q8z93kd7t4j9kbb_f7p00000gn/T/parcels-501/b0ae13053c6aaee15a9debc469bb9223.so\n" ] } ], "source": [ "pset.execute(AdvectionRK4,\n", " runtime=timedelta(days=10),\n", " dt=timedelta(minutes=5),\n", " output_file=pset.ParticleFile(name=\"GlobCurrentParticles\", outputdt=timedelta(hours=6)))" ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "Now visualise this simulation using the `plotParticles` script again. Note you can plot the particles on top of one of the velocity fields using the `tracerfile`, `tracerfield`, etc keywords." ] }, { "cell_type": "code", "execution_count": 22, "metadata": { "collapsed": false, "deletable": true, "editable": true }, "outputs": [ { "data": { "image/png": "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\n", "text/plain": [ "" ] }, "metadata": {}, "output_type": "display_data" }, { "data": { "text/plain": [ "" ] }, "execution_count": 22, "metadata": {}, "output_type": "execute_result" } ], "source": [ "plotTrajectoriesFile('GlobCurrentParticles.nc',\n", " tracerfile='GlobCurrent_example_data/20020101000000-GLOBCURRENT-L4-CUReul_hs-ALT_SUM-v02.0-fv01.0.nc',\n", " tracerlon='lon',\n", " tracerlat='lat',\n", " tracerfield='eastward_eulerian_current_velocity')" ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "## Sampling a Field with Particles" ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "One typical use case of particle simulations is to sample a Field (such as temperature, vorticity or sea surface hight) along a particle trajectory. In Parcels, this is very easy to do, with a custom Kernel." ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "Let's read in another example, the flow around a Peninsula (see [Fig 2.2.3 in this document](http://archimer.ifremer.fr/doc/00157/26792/24888.pdf)), and this time also load the Pressure (`P`) field, using `extra_fields={'P': 'P'}`. Note that, because this flow does not depend on time, we need to set `allow_time_extrapolation=True` when reading in the fieldset." ] }, { "cell_type": "code", "execution_count": 23, "metadata": { "collapsed": false, "deletable": true, "editable": true }, "outputs": [], "source": [ "fieldset = FieldSet.from_parcels(\"Peninsula_data/peninsula\", extra_fields={'P': 'P'}, allow_time_extrapolation=True)" ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "Now define a new `Particle` class that has an extra `Variable`: the pressure. We initialise this by sampling the `fieldset.P` field." ] }, { "cell_type": "code", "execution_count": 24, "metadata": { "collapsed": true, "deletable": true, "editable": true }, "outputs": [], "source": [ "class SampleParticle(JITParticle): # Define a new particle class\n", " p = Variable('p', initial=fieldset.P) # Variable 'p' initialised by sampling the pressure" ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "Now define a `ParticleSet` using the `from_line` method also used above in the GlobCurrent data. Plot the `pset` and print their pressure values `p`" ] }, { "cell_type": "code", "execution_count": 25, "metadata": { "collapsed": false, "deletable": true, "editable": true }, "outputs": [ { "data": { "image/png": "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\n", "text/plain": [ "" ] }, "metadata": {}, "output_type": "display_data" }, { "name": "stdout", "output_type": "stream", "text": [ "p values before execution: [-4.6339731, -13.038223, -22.007469, -31.454386, -41.185543]\n" ] } ], "source": [ "pset = ParticleSet.from_line(fieldset=fieldset, pclass=SampleParticle, \n", " start=(0.1, 0.05), finish=(0.1, 0.4), size=5, time=0)\n", "pset.show(field=fieldset.P, vmax=1)\n", "print 'p values before execution:', [p.p for p in pset]" ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "Now create a custom function that samples the `fieldset.P` field at the particle location. Cast this function to a `Kernel`." ] }, { "cell_type": "code", "execution_count": 26, "metadata": { "collapsed": false, "deletable": true, "editable": true }, "outputs": [], "source": [ "def SampleP(particle, fieldset, time, dt): # Custom function that samples fieldset.P at particle location\n", " particle.p = fieldset.P[time, particle.lon, particle.lat, particle.depth]\n", "\n", "k_sample = pset.Kernel(SampleP) # Casting the SampleP function to a kernel." ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "Finally, execute the `pset` with a combination of the `AdvectionRK4` and `SampleP` kernels, plot the `pset` and print their new pressure values `p`" ] }, { "cell_type": "code", "execution_count": 27, "metadata": { "collapsed": false, "deletable": true, "editable": true }, "outputs": [ { "name": "stderr", "output_type": "stream", "text": [ "INFO: Compiled SampleParticleAdvectionRK4SampleP ==> /var/folders/r2/8593q8z93kd7t4j9kbb_f7p00000gn/T/parcels-501/a1efa87239f0503ec3a36b54282be753.so\n" ] }, { "data": { "image/png": "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\noKCgoCAb/x9/kIt3BxQAcgAAAABJRU5ErkJggg==\n", "text/plain": [ "" ] }, "metadata": {}, "output_type": "display_data" }, { "name": "stdout", "output_type": "stream", "text": [ "p values after execution: [-4.6339455, -13.037563, -22.007502, -31.454361, -41.18549]\n" ] } ], "source": [ "pset.execute(AdvectionRK4 + k_sample, # Add kernels using the + operator.\n", " runtime=timedelta(hours=20),\n", " dt=timedelta(minutes=5))\n", "pset.show(field=fieldset.P, vmax=1)\n", "print 'p values after execution:', [p.p for p in pset]" ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "And see that these pressure values `p` are (within roundoff errors) the same as the pressure values before the execution of the kernels. The particles thus stay on isobars!" ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "## Calculating distance travelled" ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "As a second example of what custom kernels can do, we will now show how to create a kernel that logs the total distance that particles have travelled." ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "First, we need to create a new `Particle` class that includes three extra variables. The `distance` variable will be written to output, but the auxiliary variables `prev_lon` and `prev_lat` won't be written to output (can be controlled using the `to_write` keyword)" ] }, { "cell_type": "code", "execution_count": 28, "metadata": { "collapsed": false, "deletable": true, "editable": true }, "outputs": [], "source": [ "class DistParticle(JITParticle): # Define a new particle class that contains three extra variables\n", " distance = Variable('distance', initial=0., dtype=np.float32) # the distance travelled\n", " prev_lon = Variable('prev_lon', dtype=np.float32, to_write=False,\n", " initial=attrgetter('lon')) # the previous longitude\n", " prev_lat = Variable('prev_lat', dtype=np.float32, to_write=False,\n", " initial=attrgetter('lat')) # the previous latitude." ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "Now define a new function `TotalDistance` that calculates the sum of Euclidean distances between the old and new locations in each RK4 step" ] }, { "cell_type": "code", "execution_count": 29, "metadata": { "collapsed": false, "deletable": true, "editable": true }, "outputs": [], "source": [ "def TotalDistance(particle, fieldset, time, dt):\n", " # Calculate the distance in latitudinal direction (using 1.11e2 kilometer per degree latitude)\n", " lat_dist = (particle.lat - particle.prev_lat) * 1.11e2\n", " # Calculate the distance in longitudinal direction, using cosine(latitude) - spherical earth\n", " lon_dist = (particle.lon - particle.prev_lon) * 1.11e2 * math.cos(particle.lat * math.pi / 180)\n", " # Calculate the total Euclidean distance travelled by the particle\n", " particle.distance += math.sqrt(math.pow(lon_dist, 2) + math.pow(lat_dist, 2))\n", "\n", " particle.prev_lon = particle.lon # Set the stored values for next iteration.\n", " particle.prev_lat = particle.lat" ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "We will run this on a `ParticleSet` containing the two particles within the idealised moving eddies fieldset from above. Note that `pclass=DistParticle` in this case" ] }, { "cell_type": "code", "execution_count": 30, "metadata": { "collapsed": true, "deletable": true, "editable": true }, "outputs": [], "source": [ "fieldset = FieldSet.from_parcels(\"MovingEddies_data/moving_eddies\")\n", "pset = ParticleSet.from_list(fieldset=fieldset, pclass=DistParticle, lon=[3.3, 3.3], lat=[46.0, 47.8])" ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "Again define a new kernel to include the function written above and execute the `ParticleSet`." ] }, { "cell_type": "code", "execution_count": 31, "metadata": { "collapsed": false, "deletable": true, "editable": true }, "outputs": [ { "name": "stderr", "output_type": "stream", "text": [ "INFO: Compiled DistParticleAdvectionRK4TotalDistance ==> /var/folders/r2/8593q8z93kd7t4j9kbb_f7p00000gn/T/parcels-501/ff72d45a3f6df0b368c6f9068a044b79.so\n" ] } ], "source": [ "k_dist = pset.Kernel(TotalDistance) # Casting the TotalDistance function to a kernel.\n", "\n", "pset.execute(AdvectionRK4 + k_dist, # Add kernels using the + operator.\n", " runtime=timedelta(days=6),\n", " dt=timedelta(minutes=5),\n", " output_file=pset.ParticleFile(name=\"EddyParticles_Dist\", outputdt=timedelta(hours=1)))" ] }, { "cell_type": "markdown", "metadata": { "deletable": true, "editable": true }, "source": [ "And finally print the distance that each particle has travelled (note that this is also stored in the `EddyParticles_Dist.nc` file)" ] }, { "cell_type": "code", "execution_count": 32, "metadata": { "collapsed": false, "deletable": true, "editable": true }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "[952.56293, 990.17273]\n" ] } ], "source": [ "print [p.distance for p in pset]" ] } ], "metadata": { "kernelspec": { "display_name": "Python 2", "language": "python", "name": "python2" }, "language_info": { "codemirror_mode": { "name": "ipython", "version": 2 }, "file_extension": ".py", "mimetype": "text/x-python", "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython2", "version": "2.7.14" } }, "nbformat": 4, "nbformat_minor": 0 }