non_ascii_to_octal: Return the input string if it only contains printable ASCII characters

[seisman]

Description of proposed changes

The non_ascii_to_octal function was added in #2584 to convert any non-ASCII characters in a string to the corresponding octal codes. It's applied to all argument strings and texts passed in Figure.text. In most cases, we don't use non-ASCII characters, so applying this function is not necessary.

This PR improve the non_ascii_to_octal function so that it simply return the input string if the input string doesn't contain any non-ASCII characters.

Here is the benchmark.

Main branch

In [1]: frompygmt.helpersimportnon_ascii_to_octalIn [2]: argstr="".join([chr(c) forcinrange(32, 127)])
In [3]: argstrOut[3]: ' !"#$%&\'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_`abcdefghijklmnopqrstuvwxyz{|}~'In [4]: %timeitnon_ascii_to_octal(argstr)
243µs ± 1.08µsperloop (mean ± std. dev. of7runs, 1,000loopseach)
In [5]: %timeitnon_ascii_to_octal(argstr+"α")
244µs ± 1.03µsperloop (mean ± std. dev. of7runs, 1,000loopseach)

This PR

In [1]: frompygmt.helpersimportnon_ascii_to_octalIn [2]: argstr="".join([chr(c) forcinrange(32, 127)])
In [3]: argstrOut[3]: ' !"#$%&\'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_`abcdefghijklmnopqrstuvwxyz{|}~'In [4]: %timeitnon_ascii_to_octal(argstr)
5.82µs ± 8.87nsperloop (mean ± std. dev. of7runs, 100,000loopseach)
In [5]: %timeitnon_ascii_to_octal(argstr+"α")
240µs ± 233nsperloop (mean ± std. dev. of7runs, 1,000loopseach)

For strings that don't contain any non-ASCII characters, this PR is much faster (5.8 µs vs 243 µs).

[codspeed-hq]

CodSpeed Performance Report

Merging #3199 will improve performances by 82.47%

_{Comparing non_ascii_to_octal/faster (1eca4e4) with main (99bc5d3)}

Summary

⚡ 43 improvements
✅ 56 untouched benchmarks

Benchmarks breakdown

	Benchmark	main	non_ascii_to_octal/faster	Change
⚡	test_basemap	91.5 ms	72.3 ms	+26.65%
⚡	test_binstats_no_outgrid	166.2 ms	128 ms	+29.8%
⚡	test_colorbar	88.1 ms	74.7 ms	+17.99%
⚡	test_config_format_date_map	266.4 ms	239.2 ms	+11.35%
⚡	test_dimfilter_no_outgrid	79.8 ms	46.3 ms	+72.14%
⚡	test_figure_repr	251 ms	176.9 ms	+41.91%
⚡	test_grd2cpt	237.2 ms	210.6 ms	+12.67%
⚡	test_grdclip_no_outgrid	72.5 ms	45.5 ms	+59.27%
⚡	test_grdcontour_labels	133.1 ms	92.5 ms	+43.86%
⚡	test_grdcut_dataarray_in_dataarray_out	94.6 ms	74 ms	+27.85%
⚡	test_grdfill_dataarray_out	59.3 ms	45.8 ms	+29.41%
⚡	test_grdfilter_dataarray_in_dataarray_out	79.7 ms	46.2 ms	+72.63%
⚡	test_grdgradient_no_outgrid	65.9 ms	45.8 ms	+44.1%
⚡	test_compute_bins_no_outfile	63.9 ms	43.7 ms	+46.35%
⚡	test_equalize_grid_no_outgrid	65.6 ms	45.4 ms	+44.31%
⚡	test_grdinfo	41.7 ms	28.3 ms	+47.51%
⚡	test_grdproject_no_outgrid[+proj=merc +ellps=WGS84 +units=m +width=10]	82.5 ms	55.7 ms	+48.21%
⚡	test_grdproject_no_outgrid[EPSG:3395 +width=10]	75.6 ms	48.8 ms	+54.87%
⚡	test_grdproject_no_outgrid[M10c]	72.6 ms	45.8 ms	+58.42%
⚡	test_grdsample_dataarray_out	78.6 ms	54.6 ms	+44%
...	...	...	...	...

ℹ️ Only the first 20 benchmarks are displayed. Go to the app to view all benchmarks.