R strip.default 默認網格條函數

說明

strip.default 是默認在網格圖中繪製條帶的函數。用戶可以編寫自己的 strip 函數，但最常見的是，這涉及使用稍微不同的參數調用 strip.default。 strip.custom 提供了一種獲取新的 strip 函數的便捷方法，該函數與 strip.default 的區別僅在於某些參數的默認值。

用法

strip.default(which.given,
              which.panel,
              var.name,
              factor.levels,
              shingle.intervals,
              strip.names = c(FALSE, TRUE),
              strip.levels = c(TRUE, FALSE),
              sep = " : ",
              style = 1,
              horizontal = TRUE,
              bg = trellis.par.get("strip.background")$col[which.given],
              fg = trellis.par.get("strip.shingle")$col[which.given],
              par.strip.text = trellis.par.get("add.text"))
strip.custom(...)

參數

which.given	整數索引，指定該條對應的條件變量。
which.panel	整數向量與條件變量的數量一樣長。內容是指定每個調節變量的當前級別的索引(因此，這對於每個不同的數據包來說都是唯一的)。這與 which.packet 的返回值相同，這是一個更準確的名稱。
var.name	字符串或表達式的向量隻要有多個條件變量即可。內容被解釋為條件變量的名稱。它們是否顯示在條帶上取決於strip.names 和style 的值(見下文)。默認情況下，顯示帶狀皰疹的名稱，但不顯示因子的名稱。
factor.levels	字符串或表達式的向量，給出當前正在繪製的條件變量的級別。對於多個條件變量，這將隨 which.given 變化。這些級別是否顯示在條帶上取決於strip.levels 和style 的值(見下文)。 factor.levels 可以為因子和帶狀皰疹指定(盡管名稱相同)，但默認情況下僅針對因子顯示它們。如果顯示，則可以通過在 par.strip.text 中指定合適的組件來縮寫標簽(請參閱 xyplot )
shingle.intervals	如果當前條對應於木瓦，則這應該是給出木瓦級別的 2 列矩陣。 (通過打印 levels(shingle) 生成的表單)。否則，應該是NULL
strip.names	長度為2的邏輯向量，指示是否將與正在繪製的條帶對應的條件變量的名稱寫入條帶上。這兩個分量分別給出因子和木瓦的值。 當 style 不是 1 和 3 之一時，該參數將被忽略。
strip.levels	長度為2的邏輯向量，指示是否將與正在繪製的條帶相對應的條件變量的級別寫入條帶上。這兩個分量分別給出因子和木瓦的值。
sep	字符或表達式，如果要顯示名稱和級別，則用作分隔符。
style	整數，當前支持值 1、2、3、4 和 5，控製因子當前級別的編碼方式。忽略帶狀皰疹(實際上，當 shingle.intervals 為非空時。 要了解 style 的值有什麽影響，最好的方法就是嘗試一下。下麵是一個簡短的說明：對於樣式值為 1 的情況，條帶以背景顏色著色，條帶文本(由其他參數確定)居中。值 3 是相同的，隻是條帶的一部分以前景色著色，指示因子的當前級別。對於樣式 2 和 4，與當前級別相對應的部分仍然以前景色著色，但是，對於 style = 2，其餘部分根本不著色，而對於 4，則用背景顏色著色。對於這兩種情況，因子的所有級別的名稱都從左到右放置在條上。樣式 5 和 6 產生相同的效果(它們在 S 中略有不同，此實現對應於 5)，它們與樣式 1 類似，隻是條帶文本不居中，而是根據當前級別定位。 請注意，與 S-PLUS 不同，style 的默認值為 1。如果 style 不是 1 或 3，則 strip.names 和 strip.levels 不起作用。
horizontal	邏輯性，指定標簽等是否應該水平。 horizontal=FALSE 對於使用 strip.left=TRUE 的麵板左側的條帶很有用
par.strip.text	包含控製每個條帶上文本的參數的列表，其中包含組件 col 、 cex 、 font 等。
bg	條帶背景顏色。
fg	條帶前景色。
...	要傳遞給 strip.default 的參數，覆蓋它通常假設的任何值

細節

網格函數的默認條帶函數。有用主要是因為 style 參數 - 非默認樣式通常提供更多信息，特別是當因子 x 的級別名稱較小時。傳統用法是 strip = function(...) strip.default(style=2,...) ，盡管可以通過使用 strip.custom 來簡化。

值

strip.default 因其副作用而被調用，即繪製適合 multi-panel 網格條件圖的條帶。 strip.custom 返回一個與 strip.default 類似的函數，但調用中指定的參數具有不同的默認值。

例子

## Traditional use
xyplot(Petal.Length ~ Petal.Width | Species, iris,
       strip = function(..., style) strip.default(..., style = 4))

## equivalent call using strip.custom
xyplot(Petal.Length ~ Petal.Width | Species, iris,
       strip = strip.custom(style = 4))

xyplot(Petal.Length ~ Petal.Width | Species, iris,
       strip = FALSE,
       strip.left = strip.custom(style = 4, horizontal = FALSE))

作者

Deepayan Sarkar Deepayan.Sarkar@R-project.org

也可以看看

xyplot , Lattice