SciPost logo

SciPost Submission Page

HYPERTILING - a high performance Python library for the generation and visualization of hyperbolic lattices

by Manuel Schrauth, Yanick Thurn, Florian Goth, Jefferson S. E. Portela, Dietmar Herdt, Felix Dusel

This is not the latest submitted version.

Submission summary

Authors (as registered SciPost users): Jefferson Portela · Manuel Schrauth
Submission information
Preprint Link: https://arxiv.org/abs/2309.10844v2  (pdf)
Code repository: https://git.physik.uni-wuerzburg.de/hypertiling/hypertiling
Date submitted: 2024-05-29 07:59
Submitted by: Schrauth, Manuel
Submitted to: SciPost Physics Codebases
Ontological classification
Academic field: Physics
Specialties:
  • Condensed Matter Physics - Computational
  • Gravitation, Cosmology and Astroparticle Physics
  • High-Energy Physics - Theory
  • Statistical and Soft Matter Physics
Approach: Computational

Abstract

HYPERTILING is a high-performance Python library for the generation and visualization of regular hyperbolic lattices embedded in the Poincar\'e disk model. Using highly optimized, efficient algorithms, hyperbolic tilings with millions of vertices can be created in a matter of minutes on a single workstation computer. Facilities including computation of adjacent vertices, dynamic lattice manipulation, refinements, as well as powerful plotting and animation capabilities are provided to support advanced uses of hyperbolic graphs. In this manuscript, we present a comprehensive exploration of the package, encompassing its mathematical foundations, usage examples, applications, and a detailed description of its implementation.

Author comments upon resubmission

Dear Referees,

Thank you for your careful reading and helpful comments.

Regarding the main criticism on one of the reports, over the need for more detailed documentation:

We opt to have a full code documentation as part of the repository, in order to - as indeed already noted by the referee - avoid an overly long and technical manuscript. This documentation is continuously improved, concomitantly with the code, as the package evolves. Also, providing extensive code details in the manuscript would risk it quickly becoming outdated, as the package developing continues.

Nevertheless, in the revised version of the manuscript we provide a new section (5.1) which addresses the code structure from a high level perspective, employing a uml-type diagram which shows the hierarchy of available kernel classes. We also now explicitly emphasize the availability of an external documentation in the Quick Start section.

Regarding the minor points raised in the report:

  • thank you for pointing out the typo in Equation 1
  • we added an explanation for the parameter "n" in Section 2.3
  • we added some clarification on the relevance of studying epidemic spreading on hyperbolic spaces at the beginning of section 6.1
  • we added the coupling constant to the Hamiltonian in Equation 37 and mentioned that it is set negative in the example we give

Best regards, Manuel Schrauth

List of changes

The revised version of the manuscript contains a new section (5.1) which addresses the code structure from a high level perspective, employing a uml-type diagram which shows the hierarchy of available kernel classes. We also now explicitly emphasize the availability of an external documentation in the Quick Start section.

Minor changes:

- we corrected a typo in Equation 1
- we added an explanation for the parameter "n" in Section 2.3
- we added some clarification on the relevance of studying epidemic spreading on hyperbolic spaces at the beginning of section 6.1
- we added the coupling constant to the Hamiltonian in Equation 37 and mentioned that it is set negative in the example we give

Current status:
Has been resubmitted

Reports on this Submission

Report #1 by Anonymous (Referee 2) on 2024-6-20 (Invited Report)

Report

The authors have positively answered my remarks, and in particular have added a technical section describind the general structure of the library.
Thus I recommend the publication.

I still do not understand eq. (1) and (2). Is it perhaps n=d+1 there?
If so, this should be corrected.

Recommendation

Ask for minor revision

  • validity: -
  • significance: -
  • originality: -
  • clarity: -
  • formatting: -
  • grammar: -

Login to report or comment