diff --git a/DESCRIPTION b/DESCRIPTION index 4f3643c9f..9d44df567 100644 --- a/DESCRIPTION +++ b/DESCRIPTION @@ -29,12 +29,9 @@ Suggests: broom, broom.helpers, broom.mixed, - dplyr, easystats, ggthemes, glmnet, - glue, - gt, learnr, marginaleffects, openintro, diff --git a/man/figures/Screenshot 2025-08-06 181554.png b/man/figures/Screenshot 2025-08-06 181554.png deleted file mode 100644 index 5a8af0bcd..000000000 Binary files a/man/figures/Screenshot 2025-08-06 181554.png and /dev/null differ diff --git a/man/figures/Screenshot 2025-08-06 181621.png b/man/figures/Screenshot 2025-08-06 181621.png deleted file mode 100644 index dd9e352e7..000000000 Binary files a/man/figures/Screenshot 2025-08-06 181621.png and /dev/null differ diff --git a/vignettes/tables.qmd b/vignettes/tables.qmd index 54edc7761..130d2320d 100644 --- a/vignettes/tables.qmd +++ b/vignettes/tables.qmd @@ -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" @@ -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 @@ -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"`). @@ -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. --- @@ -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. --- @@ -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. --- @@ -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