datetick

Sensible date/time tick labels for Matplotlib

Motivation

Matplotlib's default date/time tick labels are often poor, and adjusting them requires using locators and formatters on an ad-hoc basis. A method or package for handling arbitrary time ranges does not exist.

In addition, the interfaces for locators and formatters complex and non-intuitive and require study and experimentation (e.g., [1], [2], [3], [4]. Tilting labels is an often-suggested solution, but this should not be needed.

datetick() contains logic for locators and formatters that apply to plots with arbitrary time ranges. One only needs to add the command datetick() after the usual plt.plot(...) command to have sensible and useable time tick labels. The primary configuration is a set of rules that account for the time range and an adjustable minimum gap between tick labels.

To prevent overlap and enforce a minimum gap, the font size is automatically reduced to a chosen minimum value. Then the number of ticks are reduced based on rules in rules.json.

Usage

import datetime as dt
import matplotlib.pyplot as plt
from datetick import datetick

dt1 = dt.datetime(2011, 1, 2)
dt2 = dt1 + dt.timedelta(days=1, hours=1, minutes=1)

plt.plot([dt1, dt2], [0.0,1.0])
datetick()
plt.show()
# or
# datetick('x') (use 'y' if y variable is datetime-like)
# or
# datetick('x', axes=plt.gca())
# or
# fig, axes = plt.subplots(2)
# plt.plot([dt1, dt2], [0.0, 1.0])
# datetick('x', axes=axes[0])

Comparison to default Matplotlib

Python-3.12/Matplotlib-3.11.1

axis=x

1. (rule change: -1 reverted)

2.

3.

4. (rule change: -1 reverted)

5.

6. (rule change: 1 reverted)

7.

8.

9.

10.

11.

12.

13.

14.

15. Cross second boundary

16. Cross minute boundary

17. Cross hour boundary

18. Cross day boundary

19. Cross month boundary

20.

21. Cross second boundary

22. Cross minute boundary

23. Cross hour boundary

24. Cross day boundary

25. Cross month boundary

26.

27. Cross second boundary

28. Cross minute boundary

29. Cross hour boundary

30. Cross day boundary

31. Cross month boundary

32. (font size change: -1.0 pt)

33. Cross second boundary (font size change: -1.0 pt)

34. Cross minute boundary (font size change: -1.0 pt)

35. Cross hour boundary (font size change: -1.0 pt)

36. Cross day boundary (font size change: -1.0 pt)

37. Cross month boundary (font size change: -1.0 pt)

38. (font size change: -2.0 pt)

39. Cross second boundary (font size change: -2.0 pt)

40. Cross minute boundary (font size change: -2.0 pt)

41. Cross hour boundary (font size change: -2.0 pt)

42. Cross day boundary (font size change: -2.0 pt)

43. Cross month boundary (font size change: -2.0 pt)

44. (font size change: -3.0 pt)

45. Cross second boundary (font size change: -3.0 pt)

46. Cross minute boundary (font size change: -3.0 pt)

47. Cross hour boundary (font size change: -3.0 pt)

48. Cross day boundary (font size change: -3.0 pt)

49. Cross month boundary (font size change: -3.0 pt)

50.

51. Cross second boundary

52. Cross minute boundary

53. Cross hour boundary

54. Cross day boundary

55. Cross month boundary

56.

57. Cross second boundary

58. Cross minute boundary

59. Cross hour boundary

60. Cross day boundary

61. Cross month boundary

62.

63. Cross second boundary

64. Cross minute boundary

65. Cross hour boundary

66. Cross day boundary

67. Cross month boundary

68. (rule change: 1 reverted)

69. Cross second boundary (rule change: 1 reverted)

70. Cross minute boundary (rule change: 1 reverted)

71. Cross hour boundary (rule change: 1 reverted)

72. Cross day boundary (rule change: 1 reverted)

73. Cross month boundary (rule change: 1 reverted)

74. (font size change: -1.0 pt)

75. Cross second boundary (font size change: -1.0 pt)

76. Cross minute boundary (font size change: -1.0 pt)

77. Cross hour boundary (font size change: -1.0 pt)

78. Cross day boundary (font size change: -1.0 pt)

79. Cross month boundary (font size change: -1.0 pt)

80. (rule change: -1 reverted)

81. Cross second boundary (rule change: -1 reverted)

82. Cross minute boundary (rule change: -1 reverted)

83. Cross hour boundary (rule change: -1 reverted)

84. Cross day boundary (rule change: -1 reverted)

85. Cross month boundary (rule change: -1 reverted)

86. (rule change: -1 reverted)

87. Cross second boundary (rule change: -1 reverted)

88. Cross minute boundary (rule change: -1 reverted)

89. Cross hour boundary (rule change: -1 reverted)

90. Cross day boundary (rule change: -1 reverted)

91. Cross month boundary (rule change: -1 reverted)

92.

93. Cross second boundary (rule change: -1 reverted)

94. Cross minute boundary (rule change: -1 reverted)

95. Cross hour boundary (rule change: -1 reverted)

96. Cross day boundary (rule change: -1 reverted)

97. Cross month boundary (rule change: -1 reverted)

98.

99. Cross second boundary

100. Cross minute boundary

101. Cross hour boundary

102. Cross day boundary

103. Cross month boundary

104.

105. Cross second boundary

106. Cross minute boundary

107. Cross hour boundary

108. Cross day boundary

109. Cross month boundary

110.

111. Cross second boundary

112. Cross minute boundary

113. Cross hour boundary

114. Cross day boundary

115. Cross month boundary

116.

117. Cross second boundary

118. Cross minute boundary

119. Cross hour boundary

120. Cross day boundary

121. Cross month boundary

122.

123. Cross second boundary

124. Cross minute boundary

125. Cross hour boundary

126. Cross day boundary

127. Cross month boundary

128.

129. Cross second boundary

130. Cross minute boundary

131. Cross hour boundary

132. Cross day boundary

133. Cross month boundary

134.

135. Cross second boundary

136. Cross minute boundary

137. Cross hour boundary

138. Cross day boundary

139. Cross month boundary

140.

141. Cross second boundary

142. Cross minute boundary

143. Cross hour boundary

144. Cross day boundary

145. Cross month boundary

146.

147. Cross second boundary

148. Cross minute boundary

149. Cross hour boundary

150. Cross day boundary

151. Cross month boundary

152.

153. Cross second boundary

154. Cross minute boundary

155. Cross hour boundary

156. Cross day boundary

157. Cross month boundary

158.

159. Cross second boundary

160. Cross minute boundary

161. Cross hour boundary

162. Cross day boundary

163. Cross month boundary

164.

165. Cross second boundary

166. Cross minute boundary

167. Cross hour boundary

168. Cross day boundary

169. Cross month boundary

170.

171. Cross second boundary

172. Cross minute boundary

173. Cross hour boundary

174. Cross day boundary

175. Cross month boundary

176.

177. Cross second boundary

178. Cross minute boundary

179. Cross hour boundary

180. Cross day boundary

181. Cross month boundary

182.

183. Cross second boundary

184. Cross minute boundary

185. Cross hour boundary

186. Cross day boundary

187. Cross month boundary

188.

189. Cross second boundary

190. Cross minute boundary

191. Cross hour boundary

192. Cross day boundary

193. Cross month boundary

194.

195. Cross second boundary

196. Cross minute boundary

197. Cross hour boundary

198. Cross day boundary

199. Cross month boundary

200.

201. Cross second boundary

202. Cross minute boundary

203. Cross hour boundary

204. Cross day boundary

205. Cross month boundary

206.

207. Cross minute boundary

208. Cross hour boundary

209. Cross day boundary

210. Cross month boundary

211.

212. Cross minute boundary

213. Cross hour boundary

214. Cross day boundary

215. Cross month boundary

216. (rule change: -1 reverted)

217. Cross minute boundary (rule change: -1 reverted)

218. Cross hour boundary (rule change: -1 reverted)

219. Cross day boundary (rule change: -1 reverted)

220. Cross month boundary (rule change: -1 reverted)

221. (rule change: -1 reverted)

222. Cross minute boundary (rule change: -1 reverted)

223. Cross hour boundary (rule change: -1 reverted)

224. Cross day boundary (rule change: -1 reverted)

225. Cross month boundary (rule change: -1 reverted)

226.

227. Cross minute boundary (rule change: -1 reverted)

228. Cross hour boundary (rule change: -1 reverted)

229. Cross day boundary (rule change: -1 reverted)

230. Cross month boundary (rule change: -1 reverted)

231. (rule change: -1 reverted)

232. Cross minute boundary (rule change: -1 reverted)

233. Cross hour boundary (rule change: -1 reverted)

234. Cross day boundary (rule change: -1 reverted)

235. Cross month boundary (rule change: -1 reverted)

236.

237. Cross minute boundary

238. Cross hour boundary

239. Cross day boundary

240. Cross month boundary

241.

242. Cross minute boundary

243. Cross hour boundary

244. Cross day boundary

245. Cross month boundary

246. (rule change: -1 reverted)

247. Cross minute boundary (rule change: -1 reverted)

248. Cross hour boundary (rule change: -1 reverted)

249. Cross day boundary (rule change: -1 reverted)

250. Cross month boundary (rule change: -1 reverted)

251.

252. Cross minute boundary

253. Cross hour boundary

254. Cross day boundary

255. Cross month boundary

256.

257. Cross minute boundary

258. Cross hour boundary

259. Cross day boundary

260. Cross month boundary

261.

262. Cross minute boundary

263. Cross hour boundary

264. Cross day boundary

265. Cross month boundary

266.

267. Cross minute boundary

268. Cross hour boundary

269. Cross day boundary

270. Cross month boundary

271.

272. Cross minute boundary

273. Cross hour boundary

274. Cross day boundary

275. Cross month boundary

276. (rule change: 1 reverted)

277. Cross minute boundary (rule change: 1 reverted)

278. Cross hour boundary (rule change: 1 reverted)

279. Cross day boundary (rule change: 1 reverted)

280. Cross month boundary (rule change: 1 reverted)

281.

282. Cross minute boundary

283. Cross hour boundary

284. Cross day boundary

285. Cross month boundary

286.

287. Cross minute boundary

288. Cross hour boundary

289. Cross day boundary

290. Cross month boundary

291. (rule change: -1 reverted)

292. Cross minute boundary (rule change: -1 reverted)

293. Cross hour boundary (rule change: -1 reverted)

294. Cross day boundary (rule change: -1 reverted)

295. Cross month boundary (rule change: -1 reverted)

296.

297. Cross minute boundary

298. Cross hour boundary

299. Cross day boundary

300. Cross month boundary

301.

302. Cross minute boundary

303. Cross hour boundary

304. Cross day boundary

305. Cross month boundary

306.

307. Cross hour boundary

308. Cross day boundary

309. Cross month boundary

310.

311. Cross hour boundary

312. Cross day boundary

313. Cross month boundary

314.

315. Cross hour boundary

316. Cross day boundary

317. Cross month boundary

318.

319. Cross hour boundary

320. Cross day boundary

321. Cross month boundary

322.

323. Cross hour boundary

324. Cross day boundary

325. Cross month boundary

326.

327. Cross hour boundary

328. Cross day boundary

329. Cross month boundary

330.

331. Cross hour boundary

332. Cross day boundary

333. Cross month boundary

334.

335. Cross hour boundary

336. Cross day boundary

337. Cross month boundary

338.

339. Cross hour boundary

340. Cross day boundary

341. Cross month boundary

342.

343. Cross hour boundary

344. Cross day boundary

345. Cross month boundary

346.

347. Cross hour boundary

348. Cross day boundary

349. Cross month boundary

350.

351. Cross hour boundary

352. Cross day boundary

353. Cross month boundary

354.

355. Cross hour boundary

356. Cross day boundary

357. Cross month boundary

358. (rule change: -1 reverted)

359. Cross hour boundary (rule change: -1 reverted)

360. Cross day boundary (rule change: -1 reverted)

361. Cross month boundary (rule change: -1 reverted)

362.

363. Cross hour boundary

364. Cross day boundary

365. Cross month boundary

366.

367. Cross hour boundary

368. Cross day boundary

369. Cross month boundary

370. (rule change: -1 reverted)

371. Cross hour boundary (rule change: -1 reverted)

372. Cross day boundary (rule change: -1 reverted)

373. Cross month boundary (rule change: -1 reverted)

374.

375. Cross hour boundary

376. Cross day boundary

377. Cross month boundary

378.

379. Cross hour boundary

380. Cross day boundary

381. Cross month boundary

382.

383. Cross day boundary

384. Cross month boundary

385.

386. Cross day boundary

387. Cross month boundary

388.

389. Cross day boundary

390. Cross month boundary

391.

392. Cross day boundary

393. Cross month boundary

394.

395. Cross day boundary

396. Cross month boundary

397.

398. Cross day boundary

399. Cross month boundary

400.

401. Cross day boundary

402. Cross month boundary

403.

404. Cross day boundary

405. Cross month boundary

406.

407. Cross day boundary

408. Cross month boundary

409.

410. Cross day boundary

411. Cross month boundary

412. (rule change: -1 reverted)

413. Cross day boundary (rule change: -1 reverted)

414. Cross month boundary (rule change: -1 reverted)

415.

416. Cross day boundary

417. Cross month boundary

418.

419. Cross day boundary

420. Cross month boundary

421. (rule change: -1 reverted)

422. Cross day boundary (rule change: -1 reverted)

423. Cross month boundary (rule change: -1 reverted)

424.

425. Cross day boundary

426. Cross month boundary

427.

428. Cross day boundary

429. Cross month boundary

430.

431. Cross day boundary

432. Cross month boundary

433.

434. Cross month boundary

435.

436. Cross month boundary

437.

438. Cross month boundary

439.

440. Cross month boundary

441.

442. Cross month boundary

443.

444. Cross month boundary

445.

446. Cross month boundary

447.

448. Cross month boundary

449.

450. Cross month boundary

451.

452. Cross month boundary

453. (rule change: -1 reverted)

454. Cross month boundary (rule change: -1 reverted)

455.

456. Cross month boundary

457.

458. Cross month boundary

459.

460. Cross month boundary

461. (rule change: -1 reverted)

462. Cross month boundary (rule change: -1 reverted)

463.

464. Cross month boundary

465.

466. Cross month boundary

467.

468. Cross month boundary

469. (rule change: -1 reverted)

470. Cross month boundary (rule change: -1 reverted)

471. (rule change: -1 reverted)

472. Cross month boundary (rule change: -1 reverted)

473. (rule change: -1 reverted)

474. Cross month boundary (rule change: -1 reverted)

475. (rule change: -1 reverted)

476. Cross month boundary (rule change: -1 reverted)

477. (rule change: -2 reverted)

478. Cross month boundary (rule change: -2 reverted)

479.

480.

481.

482.

483. (rule change: -1 reverted)

484. (rule change: -1 reverted)

485. (rule change: -1 reverted)

486. (rule change: -1 reverted)

487. (rule change: -1 reverted)

488. (rule change: -1 reverted)

489.

490.

491.

492.

493. (rule change: -1 reverted)

494. (rule change: -1 reverted)

495. (rule change: -1 reverted)

496. (rule change: -1 reverted)

497. (rule change: -1 reverted)

498.

499.

500.

501.

502.

503.

504.

505.

506. (rule change: -1 reverted)

507. (rule change: -2 reverted)

508. (rule change: -2 reverted)

509.

510.

511.

512.

513.

514.

515.

516.

517.

518. (rule change: -1 reverted)

519. (rule change: -1 reverted)

520. (rule change: -1 reverted)

521. (rule change: -1 reverted)

522.

523.

524.

525.

526.

527.

528.

529.

530.

531.

532.

533.

534.

535.

536.

537.

538.

539. (rule change: 1 reverted)

540. (rule change: 1 reverted)

541. (rule change: -1 reverted)

542. (rule change: -1 reverted)

543.

544.

545.

546.

547.

548.

549.

550. (rule change: -1 reverted)

551. (rule change: -1 reverted)

552.

553.

554.

555.

556.

557.

558.