racket/collects/plot/plot3d/rectangle.rkt
Neil Toronto 5a2aa226fb Initial commit for `typed/plot' module
I also made some minor changes to `plot' so that its functions would
type more easily. In particular, everything that used to take a list
of vectors now accepts a (Sequenceof (Sequenceof Real)). The 3D
discrete histogram renderers now also accept lists as well as vectors
in the sequence of categories.

For now, in typed/plot functions, optional non-keyword arguments are
required. As soon as Vincent closes PR 13354, I should be able to
uncomment part of a macro in "typed/plot/syntax.rkt" to make them
correctly optional.
2012-12-15 21:22:50 -07:00

191 lines
10 KiB
Racket

#lang racket/base
;; Functions to create renderers for 3D histograms
(require racket/match racket/list racket/contract racket/class racket/sequence
unstable/latent-contract/defthing
unstable/contract
plot/utils
"../common/utils.rkt")
(provide (all-defined-out))
;; ===================================================================================================
;; Rectangles
(define ((rectangles3d-render-proc rects color style line-color line-width line-style alpha label)
area)
(send area put-pen line-color line-width line-style)
(send area put-brush color style)
(send area put-alpha alpha)
(for ([rect (in-list rects)])
(send area put-rect rect))
(cond [label (rectangle-legend-entry label color style line-color line-width line-style)]
[else empty]))
(defproc (rectangles3d
[rects (sequence/c (sequence/c ivl?))]
[#:x-min x-min (or/c rational? #f) #f] [#:x-max x-max (or/c rational? #f) #f]
[#:y-min y-min (or/c rational? #f) #f] [#:y-max y-max (or/c rational? #f) #f]
[#:z-min z-min (or/c rational? #f) #f] [#:z-max z-max (or/c rational? #f) #f]
[#:color color plot-color/c (rectangle-color)]
[#:style style plot-brush-style/c (rectangle-style)]
[#:line-color line-color plot-color/c (rectangle-line-color)]
[#:line-width line-width (>=/c 0) (rectangle3d-line-width)]
[#:line-style line-style plot-pen-style/c (rectangle-line-style)]
[#:alpha alpha (real-in 0 1) (rectangle-alpha)]
[#:label label (or/c string? #f) #f]
) renderer3d?
(let ([rects (sequence->listof-vector 'rectangles3d rects 3)])
(match-define (list (vector (ivl x1s x2s) (ivl y1s y2s) (ivl z1s z2s)) ...) rects)
(define rxs (filter rational? (append x1s x2s)))
(define rys (filter rational? (append y1s y2s)))
(define rzs (filter rational? (append z1s z2s)))
(cond
[(or (empty? rxs) (empty? rys) (empty? rzs)) (renderer3d #f #f #f #f)]
[else
(let ([x-min (if x-min x-min (apply min* rxs))]
[x-max (if x-max x-max (apply max* rxs))]
[y-min (if y-min y-min (apply min* rys))]
[y-max (if y-max y-max (apply max* rys))]
[z-min (if z-min z-min (apply min* rzs))]
[z-max (if z-max z-max (apply max* rzs))])
(renderer3d (vector (ivl x-min x-max) (ivl y-min y-max) (ivl z-min z-max)) #f
default-ticks-fun
(rectangles3d-render-proc rects color style line-color line-width line-style
alpha label)))])))
;; ===================================================================================================
;; Discrete histograms
(define ((discrete-histogram3d-ticks-fun
c1s c2s tick-xs tick-ys add-x-ticks? add-y-ticks? x-far-ticks? y-far-ticks?) r)
(match-define (vector _xi _yi (ivl z-min z-max)) r)
(define-values (x-ticks x-far-ticks)
(let ([ts (cond [add-x-ticks? (for/list ([cat (in-list c1s)] [x (in-list tick-xs)])
(tick x #t (->plot-label cat)))]
[else empty])])
(if x-far-ticks? (values empty ts) (values ts empty))))
(define-values (y-ticks y-far-ticks)
(let ([ts (cond [add-y-ticks? (for/list ([cat (in-list c2s)] [y (in-list tick-ys)])
(tick y #t (->plot-label cat)))]
[else empty])])
(if y-far-ticks? (values empty ts) (values ts empty))))
(values x-ticks x-far-ticks
y-ticks y-far-ticks
((plot-z-ticks) z-min z-max) ((plot-z-far-ticks) z-min z-max)))
(define (adjust/gap i gap)
(match-define (ivl x1 x2) i)
(define 1/2-gap-size (* 1/2 gap (- x2 x1)))
(ivl (+ x1 1/2-gap-size) (- x2 1/2-gap-size)))
(defproc (discrete-histogram3d
[cat-vals (sequence/c (or/c (vector/c any/c any/c (or/c real? ivl? #f))
(list/c any/c any/c (or/c real? ivl? #f))))]
[#:x-min x-min (or/c rational? #f) 0] [#:x-max x-max (or/c rational? #f) #f]
[#:y-min y-min (or/c rational? #f) 0] [#:y-max y-max (or/c rational? #f) #f]
[#:z-min z-min (or/c rational? #f) 0] [#:z-max z-max (or/c rational? #f) #f]
[#:gap gap (real-in 0 1) (discrete-histogram-gap)]
[#:color color plot-color/c (rectangle-color)]
[#:style style plot-brush-style/c (rectangle-style)]
[#:line-color line-color plot-color/c (rectangle-line-color)]
[#:line-width line-width (>=/c 0) (rectangle3d-line-width)]
[#:line-style line-style plot-pen-style/c (rectangle-line-style)]
[#:alpha alpha (real-in 0 1) (rectangle-alpha)]
[#:label label (or/c string? #f) #f]
[#:add-x-ticks? add-x-ticks? boolean? #t]
[#:add-y-ticks? add-y-ticks? boolean? #t]
[#:x-far-ticks? x-far-ticks? boolean? #f]
[#:y-far-ticks? y-far-ticks? boolean? #f]
) renderer3d?
(let ([cat-vals (sequence->list cat-vals)])
(match-define (list (or (vector cat1s cat2s zs) (list cat1s cat2s zs)) ...) cat-vals)
(define rzs (filter rational? (append* (for/list ([z (in-list zs)])
(match z
[(ivl z1 z2) (list z1 z2)]
[_ (list z)])))))
(cond
[(empty? rzs) (renderer3d #f #f #f #f)]
[else
(define c1s (remove-duplicates cat1s))
(define c2s (remove-duplicates cat2s))
(define x-num (length c1s))
(define y-num (length c2s))
(let* ([x-min (if x-min x-min 0)]
[x-max (if x-max x-max (+ x-min x-num))]
[y-min (if y-min y-min 0)]
[y-max (if y-max y-max (+ y-min y-num))]
[z-min (if z-min z-min (apply min* rzs))]
[z-max (if z-max z-max (apply max* rzs))])
(define xs (linear-seq x-min x-max (add1 x-num)))
(define ys (linear-seq y-min y-max (add1 y-num)))
(define h (make-hash (for/list ([c1 (in-list cat1s)] [c2 (in-list cat2s)] [z (in-list zs)])
(cons (cons c1 c2) z))))
(match-define (list (vector x1s x2s y1s y2s all-zs) ...)
(for/list ([y1 (in-list ys)]
[y2 (in-list (rest ys))]
[c2 (in-list c2s)]
#:when #t
[x1 (in-list xs)]
[x2 (in-list (rest xs))]
[c1 (in-list c1s)])
(vector x1 x2 y1 y2 (hash-ref h (cons c1 c2) +nan.0))))
(define tick-xs (linear-seq x-min x-max x-num #:start? #f #:end? #f))
(define tick-ys (linear-seq y-min y-max y-num #:start? #f #:end? #f))
(define rects (map (λ (x1 x2 y1 y2 z)
(vector (adjust/gap (ivl x1 x2) gap)
(adjust/gap (ivl y1 y2) gap)
(if (ivl? z) z (ivl 0 z))))
x1s x2s y1s y2s all-zs))
(renderer3d
(vector (ivl x-min x-max) (ivl y-min y-max) (ivl z-min z-max)) #f
(discrete-histogram3d-ticks-fun c1s c2s tick-xs tick-ys
add-x-ticks? add-y-ticks? x-far-ticks? y-far-ticks?)
(rectangles3d-render-proc rects color style line-color line-width line-style
alpha label)))])))
(defproc (stacked-histogram3d
[cat-vals (sequence/c (or/c (vector/c any/c any/c (sequence/c real?))
(list/c any/c any/c (sequence/c real?))))]
[#:x-min x-min (or/c rational? #f) 0] [#:x-max x-max (or/c rational? #f) #f]
[#:y-min y-min (or/c rational? #f) 0] [#:y-max y-max (or/c rational? #f) #f]
[#:z-min z-min (or/c rational? #f) 0] [#:z-max z-max (or/c rational? #f) #f]
[#:gap gap (real-in 0 1) (discrete-histogram-gap)]
[#:colors colors (plot-colors/c nat/c) (stacked-histogram-colors)]
[#:styles styles (plot-brush-styles/c nat/c) (stacked-histogram-styles)]
[#:line-colors line-colors (plot-colors/c nat/c) (stacked-histogram-line-colors)]
[#:line-widths line-widths (pen-widths/c nat/c) (stacked-histogram-line-widths)]
[#:line-styles line-styles (plot-pen-styles/c nat/c) (stacked-histogram-line-styles)]
[#:alphas alphas (alphas/c nat/c) (stacked-histogram-alphas)]
[#:labels labels (labels/c nat/c) '(#f)]
[#:add-x-ticks? add-x-ticks? boolean? #t]
[#:add-y-ticks? add-y-ticks? boolean? #t]
[#:x-far-ticks? x-far-ticks? boolean? #f]
[#:y-far-ticks? y-far-ticks? boolean? #f]
) (listof renderer3d?)
(let ([cat-vals (sequence->list cat-vals)])
(match-define (list (or (vector cat1s cat2s zs) (list cat1s cat2s zs)) ...) cat-vals)
(let ([zs (map sequence->list zs)])
(define zss (map cumulative-sum zs))
(define z-ivlss (for/list ([zs (in-list zss)])
(for/list ([z1 (in-list zs)] [z2 (in-list (rest zs))])
(ivl z1 z2))))
(define max-num (apply max (map length zss)))
(for/list ([z-ivls (in-list (transpose z-ivlss))]
[color (in-cycle (maybe-apply colors max-num))]
[style (in-cycle (maybe-apply styles max-num))]
[line-color (in-cycle (maybe-apply line-colors max-num))]
[line-width (in-cycle (maybe-apply line-widths max-num))]
[line-style (in-cycle (maybe-apply line-styles max-num))]
[alpha (in-cycle (maybe-apply alphas max-num))]
[label (in-cycle (maybe-apply labels max-num))])
(discrete-histogram3d
(map vector cat1s cat2s z-ivls)
#:x-min x-min #:x-max x-max #:y-min y-min #:y-max y-max #:z-min z-min #:z-max z-max #:gap gap
#:color color #:style style #:line-color line-color #:line-width line-width
#:line-style line-style #:alpha alpha #:label label
#:add-x-ticks? add-x-ticks? #:add-y-ticks? add-y-ticks?
#:x-far-ticks? x-far-ticks? #:y-far-ticks? y-far-ticks?)))))