Index: trunk/UTIL/PYTHON/README.PP
===================================================================
--- trunk/UTIL/PYTHON/README.PP	(revision 502)
+++ trunk/UTIL/PYTHON/README.PP	(revision 504)
@@ -12,7 +12,7 @@
 **************************************
 
-*****************************************************************
-MAPMODE 1... MAPPING MODE... SIMPLE EXAMPLES on a SAMPLE GCM FILE
-*****************************************************************
+************************************
+SIMPLE EXAMPLES on a SAMPLE GCM FILE
+************************************
 Goal: The simplest, most minimal example. Mapping topography.
 pp.py -f diagfired.nc
@@ -51,4 +51,7 @@
 pp.py -f diagfired.nc -v tauice -m 0.2 -M 0.9 -H -b vishires -p ortho
 
+Goal: I want the same map, but projected on the sphere and centered on longitude 100°
+pp.py -f diagfired.nc -v tauice -m 0.2 -M 0.9 -H -b vishires -p ortho --blon -100
+
 Goal: I want the same map, but projected with north polar stereographic view
 pp.py -f diagfired.nc -v tauice -m 0.2 -M 0.9 -H -b vishires -p npstere
@@ -67,22 +70,44 @@
 
 Goal: I want to plot results for two different times in the file next to one another
-pp.py -f diagfi.nc -v tsurf --time 4 --time 7
+pp.py -f diagfired.nc -v tsurf --time 0.5 --time 0.9
 
 Goal: I want to plot averaged results in the file from one time to another time
-pp.py -f diagfi.nc -v tsurf --time 4,7
+pp.py -f diagfired.nc -v tsurf --time 0.5,0.9
 
 Goal: I want to plot the minimum/maximum value over times stored in the file
-pp.py -f diagfi.nc -v tsurf --redope mint
-pp.py -f diagfi.nc -v tsurf --redope maxt
+pp.py -f diagfired.nc -v tsurf --redope mint
+pp.py -f diagfired.nc -v tsurf --redope maxt
+
+Goal: I want to plot a section of temperature at longitude 0
+pp.py -f diagfired.nc --var temp --lon 0 --time 0.5
+
+Goal: I want to plot a section of zonally-averaged temperature
+pp.py -f diagfired.nc -v temp --lon -180,180 --time 0.5
+
+Goal: I want to plot a section of zonally-averaged temperature with contours of zonally-averaged zonal wind
+pp.py -f diagfired.nc -v temp -w u --lon -180,180 --time 0.5
+
+Goal: I want to plot a section of zonally-averaged temperature and zonally-averaged zonal wind
+pp.py -f diagfired.nc -v temp,u --lon -180,180 --time 0.5
 
 Goal: I want to plot a globally-averaged 1D temperature profile
-pp.py -f diagfi.nc -v temp --time 4 --lat -90,90 --lon -180,180
+pp.py -f diagfired.nc -v temp --time 0.5 --lat -90,90 --lon -180,180
 
 Goal: I want to overplot few globally-averaged 1D temperature profiles at different times
-pp.py -f diagfi.nc -v temp --time 4 --time 7 --lat -90,90 --lon -180,180
-
-[only mesoscale for the moment]
+pp.py -f diagfired.nc -v temp --time 0.5 --time 0.9 --lat -90,90 --lon -180,180
+
+Goal: I want to overplot lat=0,lon=0 1D temperature profiles at different times
+pp.py -f diagfired.nc -v temp --time 0.5 --time 0.9 --lat 0 --lon 0 --ymax 20 --xmin 180.
+
+******************** [specific mesoscale]
+
 Goal: I want to plot results for two different LOCAL times in the file next to one another
-pp.py -f wrfout**** -v TSURF --time 4 -- time 7 --axtime lt
+pp.py -f wrfout_d01_2024-05-03_01:00:00 -v TSURF --time 4 --time 7 --axtime lt
+
+Goal: I want to plot a section of temperature at longitude -120 between AMR altitudes 0 km and 30 km with 50 levels
+pp.py -f wrfout_d01_2024-05-03_01:00:00 -v tk --time 4 --axtime lt --lon -120 -i 3 -l 0,30,50
+
+Goal: I want to plot a section of temperature at longitude -120 between ALS altitudes 0 km and 30 km with 50 levels
+pp.py -f wrfout_d01_2024-05-03_01:00:00 -v tk --time 4 --axtime lt --lon -120 -i 4 -l 0,30,50
 
 ***********************************************************************************
@@ -152,4 +177,5 @@
 		relaxed towards prescribed GCM fields.
 
+
 ***********************************************************************************
 Simple 2D plot: Zonal mean.
@@ -158,9 +184,9 @@
 Goal:
 
-Plot the zonal mean temperature from a netcdf fiel representing one month.
-
-Command:
-
-gcm.py -f POLAR_NIGHT_RUN/diagfi16.nc --var temp --lon 180,-180 --time 0,65
+Plot the zonal mean temperature from a netcdf field representing one month.
+
+Command:
+
+pp.py -f POLAR_NIGHT_RUN/diagfi16.nc --var temp --lon 180,-180 --time 0,65
 
 Note:
@@ -180,5 +206,5 @@
 Command:
 
-gcm.py -f POLAR_NIGHT_RUN/diagfi16.nc --var temp --lon -180,180 --time 0,65 -i 4
+pp.py -f POLAR_NIGHT_RUN/diagfi16.nc --var temp --lon -180,180 --time 0,65 -i 4
 
 Note:
@@ -199,5 +225,5 @@
 Command:
 
-gcm.py -f POLAR_NIGHT_RUN/stats16.nc --var temp --lon -180,180 --time 1 -i 4 --fref POLAR_NIGHT_REF/stats16.nc --operation - --mope -2 --Mope 2 --title "Polar temperatures with new parametrizations" --titleref "Reference run"
+pp.py -f POLAR_NIGHT_RUN/stats16.nc --var temp --lon -180,180 --time 1 -i 4 --fref POLAR_NIGHT_REF/stats16.nc --operation - --mope -2 --Mope 2 --title "Polar temperatures with new parametrizations" --titleref "Reference run"
 
 Note:
@@ -207,5 +233,5 @@
 One can combine this command with projections and means, so that for example, to compare co2 depletion at the south pole:
 
-gcm.py -f POLAR_NIGHT_RUN/start16.nc --var co2 --vert 0,150 --proj spstere --time 1 -i 4 --fref POLAR_NIGHT_REF/start16.nc --operation - --mope -0.5 --Mope 0.5 --title "Polar co2 with new parametrizations" --titleref "Reference run"
+pp.py -f POLAR_NIGHT_RUN/start16.nc --var co2 --vert 0,150 --proj spstere --time 1 -i 4 --fref POLAR_NIGHT_REF/start16.nc --operation - --mope -0.5 --Mope 0.5 --title "Polar co2 with new parametrizations" --titleref "Reference run"
 
 ***********************************************************************************
@@ -219,5 +245,5 @@
 Command:
 
-gcm.py -f TES.MappedClimatology.nadir.MY25.nc --var T_nadir_day --lat -76. --time 90 --ymin 500 --ymax 1 -m 128 -M 148 -H
+pp.py -f TES.MappedClimatology.nadir.MY25.nc --var T_nadir_day --lat -76. --time 90 --ymin 500 --ymax 1 -m 128 -M 148 -H
 
 Note: