On this page:
7.1 Turning the optimizer off
7.2 Getting the most out of the optimizer
7.2.1 Numeric types
7.2.2 Lists
7.2.3 Vectors
7.2.4 Contract boundaries
8.15.0.2

7 Optimization in Typed Racket🔗ℹ

For general information on Racket performance and benchmarking, see Performance.

Typed Racket provides a type-driven optimizer that rewrites well-typed programs to potentially make them faster.

7.1 Turning the optimizer off🔗ℹ

Typed Racket’s optimizer is turned on by default. If you want to deactivate it (for debugging, for instance), you must add the #:no-optimize keyword when specifying the language of your program:

#lang typed/racket #:no-optimize

The optimizer is also disabled when executing a typed racket program in a sandbox (see Sandboxed Evaluation) and when the environment variable PLT_TR_NO_OPTIMIZE is set (to any value).

7.2 Getting the most out of the optimizer🔗ℹ

Typed Racket’s optimizer can improve the performance of various common Racket idioms. However, it does a better job on some idioms than on others. By writing your programs using the right idioms, you can help the optimizer help you.

To best take advantage of the Typed Racket optimizer, consult the Optimization Coach documentation.

The Typed Racket optimizer logs events with the topic 'TR-optimizer. See Logging to learn how to receive these log events.

7.2.1 Numeric types🔗ℹ

Being type-driven, the optimizer makes most of its decisions based on the types you assigned to your data. As such, you can improve the optimizer’s usefulness by writing informative types.

For example, the following programs both typecheck:
(define (f [x : Real])  : Real  (+ x 2.5))
(f 3.5)
(define (f [x : Float]) : Float (+ x 2.5))
(f 3.5)

However, the second one uses more informative types: the Float type includes only 64-bit floating-point numbers whereas the Real type includes both exact and inexact real numbers and the Inexact-Real type includes both 32- and 64-bit floating-point numbers. Typed Racket’s optimizer can optimize the latter program to use float -specific operations whereas it cannot do anything with the former program.

Thus, to get the most of Typed Racket’s optimizer, you should use the Float type when possible. For similar reasons, you should use floating-point literals instead of exact literals when doing floating-point computations.

When mixing floating-point numbers and exact reals in arithmetic operations, the result is not necessarily a Float. For instance, the result of (* 2.0 0) is 0 which is not a Float. This can result in missed optimizations. To prevent this, when mixing floating-point numbers and exact reals, coerce exact reals to floating-point numbers using real->double-flonum. This is not necessary when using + or -. When mixing floating-point numbers of different precisions, results use the highest precision possible.

On a similar note, the Float-Complex type is preferable to the Complex type for the same reason. Typed Racket can keep float complex numbers unboxed; as such, programs using complex numbers can have better performance than equivalent programs that represent complex numbers as two real numbers. As with floating-point literals, float complex literals (such as 1.0+1.0i) should be preferred over exact complex literals (such as 1+1i).

To get the most of Typed Racket’s optimizer, you should also favor rectangular coordinates over polar coordinates.

Note that on Racket BC, it is possible to have complex numbers where one component is exact and the other is inexact. These values, including literals written +1.0i, do not have the type Float-Complex. On Racket CS, such mixed-exactness values do not exist.

7.2.2 Lists🔗ℹ

Typed Racket handles potentially empty lists and lists that are known to be non-empty differently: when taking the car or the cdr of a list Typed Racket knows is non-empty, it can skip the check for the empty list that is usually done when calling car and cdr.

(define (sum [l : (Listof Integer)]) : Integer
  (if (null? l)
      0
      (+ (car l) (sum (cdr l)))))

In this example, Typed Racket knows that if we reach the else branch, l is not empty. The checks associated with car and cdr would be redundant and are eliminated.

In addition to explicitly checking for the empty list using null?, you can inform Typed Racket that a list is non-empty by using the known-length list type constructor; if your data is stored in lists of fixed length, you can use the List type constructors.

For instance, the type of a list of two Integers can be written either as:

(define-type List-2-Ints (Listof Integer))

or as the more precise:

(define-type List-2-Ints (List Integer Integer))

Using the second definition, all car and cdr-related checks can be eliminated in this function:
(define (sum2 [l : List-2-Ints]) : Integer
  (+ (car l) (car (cdr l))))

7.2.3 Vectors🔗ℹ

In addition to known-length lists, Typed Racket supports known-length vectors through the Vector type constructor. Known-length vector access using constant indices can be optimized in a similar fashion as car and cdr.

; #(color r g b)
(define-type Color (Vector String Integer Integer Integer))
(define x : Color (vector "red" 255 0 0))
(vector-ref x 0) ; good
(define color-name 0)
(vector-ref x color-name) ; good
(vector-ref x (* 0 10)) ; bad

In many such cases, however, structs are preferable to vectors. Typed Racket can optimize struct access in all cases.

7.2.4 Contract boundaries🔗ℹ

When interoperating with untyped code (see Typed-Untyped Interaction), contracts are installed between typed and untyped modules. Contracts can have significant overhead, thus typed-untyped boundary crossings should be avoided in performance-sensitive code.

Typed Racket provides types for most of the bindings provided by #lang racket; using require/typed is unnecessary in these cases.

If you suspect that contracts at a typed-untyped boundary may have a significant cost in your program, you can investigate further using the contract profiler.

If the contract profiler is not already installed, the following command will install it:

  raco pkg install contract-profile