Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 0 additions & 3 deletions DESCRIPTION
Original file line number Diff line number Diff line change
Expand Up @@ -29,12 +29,9 @@ Suggests:
broom,
broom.helpers,
broom.mixed,
dplyr,
easystats,
ggthemes,
glmnet,
glue,
gt,
learnr,
marginaleffects,
openintro,
Expand Down
Binary file removed man/figures/Screenshot 2025-08-06 181554.png
Binary file not shown.
Binary file removed man/figures/Screenshot 2025-08-06 181621.png
Binary file not shown.
42 changes: 5 additions & 37 deletions vignettes/tables.qmd
Original file line number Diff line number Diff line change
@@ -1,32 +1,3 @@
## The "More" Column

One of the key features of both the Preceptor and Population tables is the automatically-added **"More" column**. This column serves several important purposes:

### Purpose and Functionality

* **Placeholder for expansion**: The "More" column acknowledges that your initial analysis might not include all relevant covariates. As you develop your model, you might discover that additional variables like "Previous Voting History", "Campaign Spending", or "District Demographics" are important.

* **Visual reminder**: By including this column in your initial table structure, you're reminded to think critically about what other variables might matter for your analysis.

* **Easy modification**: Rather than having to restructure your entire table when you want to add a new covariate, you can simply replace the "More" column header and add additional "More" columns as needed.

### How It Works

* The "More" column is automatically added during table rendering by the `expand_input_tibble()` function
* It's not part of your initial `p_tibble` or `d_tibble` - those contain only the variables you explicitly specify
* The column is filled with `"..."` placeholders in all rows
* It's grouped under the "Covariates" spanner along with your main covariate column

### Practical Usage

When you're ready to expand your analysis:

1. **Replace the header**: Change `"More"` to your new variable name (e.g., `"Previous Experience"`)
2. **Add content**: Replace the `"..."` placeholders with actual values
3. **Add another "More"**: If you need space for yet another variable, you can manually add another "More" column

This design encourages iterative analysis development while maintaining a clean, organized table structure from the start.

---
title: "Preceptor and Population Tables"
author: "David Kane and Aashna Patel"
Expand Down Expand Up @@ -54,7 +25,7 @@ This format draws inspiration from the [Cardinal Virtues](https://ppbds.github.i

### Preceptor Table

A **Preceptor Table** contains hypothetical or expected outcomes for units (such as students or senators). It often includes unknowns (denoted by `"..."`) where real data is not yet available, and reflects researcher or instructor expectations. The table automatically includes a blank third row and a "More" column for additional covariates that you might want to include in your analysis.
A **Preceptor Table** contains hypothetical or expected outcomes for units (such as students or senators). It often includes unknowns (denoted by `"..."`) where real data is not yet available, and reflects researcher or instructor expectations. The table automatically includes a blank third row and a "More" column for additional covariates.

### Population Table

Expand All @@ -78,7 +49,7 @@ Each table includes spanners for:
* **Unit/Time** (for the unit columns)
* **Potential Outcomes** (for causal models) or **Outcome** (for predictive models)
* **Treatment** (included only in causal models)
* **Covariates** (includes the main covariate column and the "More" column for additional variables you might identify during analysis)
* **Covariates** (includes the covariate column and the "More" column)

> **Note:** All table entries must be surrounded by **double quotes**, even for numeric values (e.g., `"42"`).

Expand Down Expand Up @@ -148,9 +119,8 @@ The `make_p_tables()` function takes a set of user-defined labels and options th
### `covariate_label` *(Character)*

* Label for the main covariate column relevant to the analysis.
* This is grouped under the `"Covariates"` spanner along with the automatically-added "More" column.
* This is grouped under the `"Covariates"` spanner along with the "More" column.
* Should be a simple phrase like `"Age"` or `"School Type"`.
* The "More" column is added during rendering and provides space for additional covariates that you might discover are important during your analysis.

---

Expand Down Expand Up @@ -182,7 +152,7 @@ Below is a guide to what each footnote is for:

* **`pre_treatment_footnote`**: Defines what the treatment actually entails and how it is operationalized. For example, a phone call campaign, assignment to tutoring, or access to a program.

* **`pre_covariates_footnote`**: Explains why the selected covariates were chosen and their role in forming expectations. Should also clarify the purpose of the "More" column - typically used to indicate that additional covariates could be relevant to the analysis but are not yet specified.
* **`pre_covariates_footnote`**: Explains why the selected covariates were chosen and their role in forming expectations. Should also clarify the "More" column purpose.

---

Expand All @@ -196,7 +166,7 @@ Below is a guide to what each footnote is for:

* **`pop_treatment_footnote`**: Explains how actual treatment status was observed or inferred. May differ from the assumptions made in the Preceptor Table.

* **`pop_covariates_footnote`**: Describes where the covariate data comes from in the population table and whether it's measured identically to the preceptor rows. Should also explain what additional variables might be included in the "More" column.
* **`pop_covariates_footnote`**: Describes where the covariate data comes from in the population table and whether it's measured identically to the preceptor rows.

---

Expand Down Expand Up @@ -385,14 +355,12 @@ After filling in the tibbles and footnotes with actual data, you would see prope
### Preceptor Table
- Uses `p_tibble` as input (3 rows of placeholders)
- Automatically adds a blank third row and "More" column via `expand_input_tibble()`
- The "More" column provides space for additional covariates you might identify later
- Results in 4 total rows for the final table

### Population Table
- Uses `d_tibble` for data input (3 rows of placeholders)
- Creates 4 data rows (3 content + 1 blank in 3rd position)
- Uses the expanded preceptor table (4 rows)
- The "More" column is carried over from the preceptor table and added to the population structure
- Combines into 11-row structure: blank + 4 data + blank + 4 preceptor + blank
- All rows are properly labeled in the Source column

Expand Down