There is a newer version of this record available.

Software Open Access

SHTOOLS/SHTOOLS: Version 4.6.1

Mark Wieczorek; MMesch; Ilya Oshchepkov; Elliott Sales de Andrade; xoviat; Benda Xu; Akihisa Hattori; Stefan Schröder; Katrin Leinweber; Andrew Walker; Aaryaman Vasishta


JSON-LD (schema.org) Export

{
  "description": "Version 4.6\nNew extended grids\n<p>All grid formats now allow to compute the redundant values at 360 E longitude (GLQ and DH), as well as at 90 S (DH only). These <em>extended</em> grids are now the default in pyshtools, but remain optional in the Fortran 95 routines. The use of extended grids is controlled by the optional argument <code>extend</code>. The purpose of these extended grids is to better integrate with the plotting routines that require these points (i.e.., Cartopy and pygmt).</p>\nImproved plotting and map projections\n<p>The plotting routine <code>SHGrid.plot()</code> has been refactored to allow support for projections using <code>Cartopy</code> and <code>pygmt</code>.</p>\n<ul>\n<li>An incorrect 0.5 pixel offset was fixed when plotting grids via matplotlib, and grids now correctly plot both 0 and 360 degrees using the new \"extended\" grids of <code>SHGrid</code>.</li>\n<li>Support was added for Cartopy projections, by specifying: <code>SHGrid.plot(projection=ccrs.ProjectionName())</code>.</li>\n<li>The argument <code>colorbar</code> now takes the options 'top', 'bottom', 'left' or 'right'.</li>\n<li>Improved plotting and placement of colorbars. New optional arguments include <code>cb_label</code> for labels, <code>cb_ylabel</code> for a label on the y axis of the colorbar, <code>cb_tick_interval</code> for specifying the major tick interval, <code>cb_minor_tick_interval</code> for specifying minor tick intervals, <code>cb_triangles</code> for plotting upper/lower limit triangles at the ends of the colorbar, <code>cb_width</code> to specify the colorbar width, and <code>cb_offset</code> to override the default spacing between the map and colorbar.</li>\n<li>Improved colormap handling: New optional arguments include <code>cmap_limits</code> to specify the lower and upper bounds of the data, as well as an interval for constant color intervals, and <code>cmap_reverse</code> to reverse the colormap.</li>\n<li>Improved handling of ticks and annotations: The optional argument <code>ticks</code> specifies which ticks and annotations to show, using a syntax from the generic mapping tools (i.e., <code>'WSen'</code>).</li>\n<li>Experimental support for pygmt using the routine <code>SHGrid.plotgmt()</code>. This function takes nearly the same arguments as <code>plot()</code>. As soon as pygmt implements projection classes (<a href=\"https://github.com/GenericMappingTools/pygmt/pull/379\">https://github.com/GenericMappingTools/pygmt/pull/379</a>), this will be incorporated into the <code>plot</code> function in the same manner as Cartopy was.</li>\n<li>All gravity, magnetics, tensor, localization windows and slepian function plotting routines incorporate these changes.</li>\n<li>Added a new introductory notebook that shows how to use all features of the <code>plot()</code> function.</li>\n</ul>\nImproved integration with xarray DataArrays, xarray DataSets, and netcdf files\n<ul>\n<li>Added the methods <code>to_netcdf()</code> and <code>from_netcdf()</code> to the <code>SHCoeffs</code>, <code>SHGravCoeffs</code> and <code>SHMagCoeffs</code> classes.</li>\n<li>Added the method <code>SHGrid.from_xarray()</code> to initialize a grid from an xarray DataArray.</li>\n<li>Added improved descriptive attributes for netcdf files that mirror these <a href=\"http://cfconventions.org/cf-conventions/cf-conventions.html\">conventions</a>.</li>\n<li>Added the method <code>SHGeoid.to_xarray()</code> to export an xarray DataArray and <code>to_netcdf()</code> to export a netcdf object readable by the generic mapping tools.</li>\n<li>Added the methods <code>SHGravGrid.to_xarray()</code> and <code>SHMagGrid.to_xarray()</code> to export all gridded data (radial, theta, phi, total, and potential) as an xarray DataSet.</li>\n<li>Added the methods <code>SHGravTensor.to_xarray()</code> and <code>SHMagTensor.to_xarray()</code>to export all gridded data (Vxx, invariants, eigenvalues) as an xarray DataSet.</li>\n</ul>\nGravity routine improvements\n<ul>\n<li>Added the method <code>SHGravCoeffs.center_of_mass</code> to calculate the center of mass of a body.</li>\n<li>Added the method <code>SHGravCoeffs.inertia_tensor()</code> to calculate the moment of inertia tensor.</li>\n<li>Added the Earth dynamical flattening constant H (IERS Conventions 2010) to the <code>constant</code> module.</li>\n<li>The <code>read_icgem_gfc()</code> function was extended with the option <code>encoding</code> as some models in ICGEM are not in UTF-8.</li>\n<li>Addded the method <code>centroid()</code> to the class <code>SHCoeffs</code>. The centroid is computed as the center of mass of a homogeneous object.</li>\n</ul>\nOther changes\n<ul>\n<li>New methods <code>SHGrid.to_real()</code> and <code>SHGrid.to_imag()</code> return the real and imaginary components of a complex <code>SHGrid</code> instance.</li>\n<li>Added an optional argument <code>copy</code> to <code>SHCoeffs.pad()</code>.</li>\n<li>Fixed bugs in the Fortran code of <code>PlBar_d1</code> and <code>PlON_d1</code> when calculating the Legendre polynomials at the north and south pole.</li>\n<li>Spherical harmonic coefficients can be read remotely by specifying a URL as the filename. This functionality uses <code>requests.get()</code>, and has been implemented in the function <code>shread()</code> and the <code>SHCoeffs</code> method <code>from_file()</code>.</li>\n<li>Fixed a bug in the fortran code of <code>Curve2Mask</code>. As part of this fix, the optional parameter <code>centralmeridian</code> has been removed as it is no longer required. The longitudes of the curve can possess values from -360 to 720 degrees, and the routine searches for discontinuities that may occur between two successive points as the longitudes pass from 360 to 0, or -180 to 180 degrees.</li>\n</ul>", 
  "license": "", 
  "creator": [
    {
      "affiliation": "Laboratoire Lagrange - Observatoire de la C\u00f4te d'Azur", 
      "@type": "Person", 
      "name": "Mark Wieczorek"
    }, 
    {
      "@type": "Person", 
      "name": "MMesch"
    }, 
    {
      "affiliation": "Center of Geodesy, Cartography and SDI (TsNIIGAiK)", 
      "@type": "Person", 
      "name": "Ilya Oshchepkov"
    }, 
    {
      "@type": "Person", 
      "name": "Elliott Sales de Andrade"
    }, 
    {
      "@type": "Person", 
      "name": "xoviat"
    }, 
    {
      "@type": "Person", 
      "name": "Benda Xu"
    }, 
    {
      "@type": "Person", 
      "name": "Akihisa Hattori"
    }, 
    {
      "affiliation": "Universit\u00e4t Bonn", 
      "@type": "Person", 
      "name": "Stefan Schr\u00f6der"
    }, 
    {
      "affiliation": "@TIBHannover", 
      "@type": "Person", 
      "name": "Katrin Leinweber"
    }, 
    {
      "@type": "Person", 
      "name": "Andrew Walker"
    }, 
    {
      "affiliation": "University of Tokyo", 
      "@type": "Person", 
      "name": "Aaryaman Vasishta"
    }
  ], 
  "url": "https://zenodo.org/record/3697770", 
  "codeRepository": "https://github.com/SHTOOLS/SHTOOLS/tree/v4.6.1", 
  "datePublished": "2020-03-05", 
  "version": "v4.6.1", 
  "@context": "https://schema.org/", 
  "identifier": "https://doi.org/10.5281/zenodo.3697770", 
  "@id": "https://doi.org/10.5281/zenodo.3697770", 
  "@type": "SoftwareSourceCode", 
  "name": "SHTOOLS/SHTOOLS: Version 4.6.1"
}
1,873
253
views
downloads
All versions This version
Views 1,8734
Downloads 2530
Data volume 5.9 GB0 Bytes
Unique views 1,6233
Unique downloads 1740

Share

Cite as