Hugging Face "Dataset Cards" documentation
Monday build block · Read it inside Monday's build block
Build-block reading · Hugging Face "Dataset Cards" documentation (huggingface.co/docs/hub/datasets-cards)
In: LABLOOP-W11 Notebook
WEEK 11 · Mon 30 Nov → Sun 06 Dec 2026
UNDERSTAND · PRACTICE · KEEP EVIDENCE
Read the week in plain language, refresh the foundations, follow each challenge step by step, and check what evidence to keep. Includes worked examples, answer keys and prompts for visual study resources.
Use this within your existing weekly blocks. Your learning completion and research evidence remain in your current tracker and week files.
START HERE · 2 MINUTES
STATUS
| Deliverable | Acceptance | State |
|---|---|---|
normalization-audit.mdBuild create + |
Normalize supported concentration/yield units, taxonomy identifiers and duplicates while preserving original strings and provenance. Acceptance: Conversions have dimensions and assumptions; incompatible percent values are not silently converted to g/L. | |
analysis-plan.mdBuild create + |
Formalize completeness questions and comparison groups; predefine effect sizes and the multiple-testing family for week 14. Acceptance: Exploratory versus planned analyses are distinguished before significance claims. | |
dataset-card-draft.mdBuild create + |
Export versioned data and draft the dataset card, known limitations and per-source rights assessment. Acceptance: A small reload check reproduces row counts and schema; redistribution terms are justified. | |
study-notes.mdLearning create + |
Selected exact free resources; bounded lesson/exercise; separate solution; quiz and grading rubric; Peter's answers and gaps when executed | |
founder-paper.mdFounder papers create + |
Verified source and P11 digest; authentic question and connection sentence; access limitations | |
branding-pack.mdBranding create + |
Wednesday note, Sunday build log, X adaptation, figure/caption/alt text and the week's special asset; each claim linked to real proof | |
opportunity-actions.mdOpportunities create + |
Qualified target/role, source/date, ladder stage, next action, message/interview/proposal draft and actual status | |
evidence.mdEvidence & review open & edit ↗ |
Actual paths/URLs, versions, checks/metrics, preparation versus execution state and external receipts when applicable | |
review.mdEvidence & review open & edit ↗ |
Checklist, learning assessment, gate status, shortfalls, next actions and carryover |
These filenames are outputs to prepare during this week's execution; this scaffold does not claim they already exist. Drafts and measured results have different states. Technical code/data stay in the canonical project repository and are referenced from these coordinating files.
During preparation, future measured tables get column definitions, input requirements and run instructions with PENDING status. During execution, replace pending values only with measured outputs. Do not create realistic-looking fake evidence.
600 MINUTES MAXIMUM
Target. Normalize supported concentration/yield units, taxonomy identifiers and duplicates while preserving original strings and provenance. Stop when: Conversions have dimensions and assumptions; incompatible percent values are not silently converted to g/L.
Do these in this order — the plan's own sequence:
Target. NPTEL lectures on kLa, mixing, scale-up Produce: kLa estimated from IndPenSim DO data
Do these in this order — the plan's own sequence:
Target. Formalize completeness questions and comparison groups; predefine effect sizes and the multiple-testing family for week 14. Stop when: Exploratory versus planned analyses are distinguished before significance claims. Reserve the last 10 minutes for the optional Wednesday note.
No material for Wednesday — this is a pure build day. Need something to study instead? →
Target. Frazier, "A Tutorial on Bayesian Optimization" — arxiv.org/abs/1807.02811; BoTorch tutorials — botorch.org Select material/exercise that fits 60 minutes; use the last 30 for the founder paper.
Do these in this order — the plan's own sequence:
Target. Export versioned data and draft the dataset card, known limitations and per-source rights assessment. Stop when: A small reload check reproduces row counts and schema; redistribution terms are justified.
No material for Friday — this is a pure build day. Need something to study instead? →
Target. Resolve the earliest critical spillover or dependency. Prepare any long-form publication draft from existing figures here if needed. Sandbox only after commitments are met.
Optional, only if the day went well:
Target. 20 min build-log draft/publication when authorized; 5 min evidence/checklist; 20 min source-grounded gap review; 15 min next week's six physical actions.
No material for Sunday — this is a pure build day. Need something to study instead? →
Spare pockets, repo exercises and anything the plan lists without a day. Take them in this order when a day finishes early.
The model must turn these into exact physical actions using the observed files and available inputs. Each 90-minute block includes start/stop rituals. All calls, posts, debugging, reading and exercises consume this same capacity.
The source lists more material than necessarily fits. Select exact excerpts for the learning objective and park the remainder; no full-course completion requirement.
WHAT TO WATCH, READ AND RUN
Anyone who has merged two companies' ERP systems knows the pain: one reports revenue in thousands, the other in units; one calls a customer "Bioceres S.A.", the other "BIOCERES". Data engineering is 80% of a merger and 80% of a dataset. This week FermLit gets its merger treatment: units normalised (g/L vs mg/L), organism names mapped to NCBI taxonomy IDs (so "Y. lipolytica" and "Yarrowia lipolytica Po1f" become the …
0 of 12 finished · give me one to start now → · open in the deck →
In the plan's running order: each card says which block it belongs to and what has to come before it. The seven-day plan lists the same cards under the day that owns them.
Monday build block · Read it inside Monday's build block
Build-block reading · Hugging Face "Dataset Cards" documentation (huggingface.co/docs/hub/datasets-cards)
In: LABLOOP-W11 Notebook
Monday · after Hugging Face "Dataset Cards" documentation
Wilkinson et al. (2016), "The FAIR Guiding Principles for scientific data management and stewardship", Scientific Data 3:160018 (4 pages)
In: LABLOOP-W11 Notebook
NPTEL Bioreactors lectures on oxygen transfer (kLa), mixing and scale-up (75 min)
In: LABLOOP-W11 Notebook
Agnihotri & Batra (2020), "Exploring Bayesian Optimization", Distill — distill.pub/2020/bayesian-optimization (30 min, interactive; start here); then Frazier (2018), "A Tutorial on Bayesian Optimization", arXiv:1807.02811, sections 1-4 (45 min)
In: LABLOOP-W11 Notebook
Saturday sandbox
Shields et al. (2021), "Bayesian reaction optimization as a tool for chemical synthesis", Nature 590:89-96 — BO beating expert chemists, the self-driving-lab argument
In: LABLOOP-W11 Notebook
Saturday sandbox · after Shields et al. (2021), "Bayesian reaction optimization as a tool for chemical synthesis"
Coursera Research Data Management and Sharing (UNC/Edinburgh), module on metadata
In: LABLOOP-W11 Notebook
Saturday sandbox · after Coursera Research Data Management and Sharing
NCBI Taxonomy and E-utilities documentation (ncbi.nlm.nih.gov/books/NBK25501) for the name-to-ID mapping
In: LABLOOP-W11 Notebook
Saturday sandbox · after NCBI Taxonomy and E-utilities documentation
Brunton "Bayesian optimization" lecture (search in his channel; verify)
In: LABLOOP-W11 Notebook
Tutorial closed_loop_botorch_only in Colab; replace the test function with your simulator's final titer as a function of 2 feed parameters
In: LABLOOP-W11 Notebook
"Getting started" BO loop in 10 lines; the higher-level alternative if BoTorch feels heavy
In: LABLOOP-W11 Notebook
Bio.Entrez to map 20 organism names to taxonomy IDs; cache results
In: LABLOOP-W11 Notebook
Create a private dataset repo, push a 100-row sample with a card; check the viewer renders
In: LABLOOP-W11 Notebook
READ FIRST
This week delivers the three concrete artifacts below and the supporting learning/branding/opportunity pack. The scientific or commercial outcome follows the preserved source brief, while the acceptance checks make its evidence testable. The career objective is to turn this work into something a scientist, hiring manager or buyer can inspect.
READ FIRST
Read v6 · Week 11 · Dataset engineering and the reporting finding before Monday. It carries this week's v5 brief unchanged and adds the Welcome analogy, Learn it (▶ core and + deeper sources), Run it (repos with a 20-40 minute exercise), the NotebookLM kit and the mentor check below. Standing v6 rules: resource rules, NotebookLM protocol, chapter anatomy. v6 adds depth only; it does not change a goal, gate, output or the 600-minute cap, so this specification still governs execution.
Act III · Threads: B, M, FL · Next gate: 13
Where this week sits. - ← From: weeks 9-10 (2,000 records, kappa, descriptive figures). - → Feeds: week 13 (HF + Zenodo release), week 14 (Methods: normalisation), week 16 (bioRxiv data availability), week 23 (UniProt/taxonomy skills reused for enzymes), Half 2 Loop Audits ("what does your data look like after normalisation?"). - ⟳ Returns in: the dataset card that makes FermLit citable and reusable (L6).
Goals. - 🎯 This week: normalised, deduplicated export; completeness-over-time result with a planned multiple-testing correction; draft HF dataset card with license. - 🏁 Next milestone: Gate 13. - 🌟 Final: a dataset others download and cite.
Mentor check. "I can explain why kLa limits scale-up, and I can show a dataset card that answers a stranger's questions before they ask."
OPEN WHEN NEEDED
READ FIRST
Source unit: B11 · Bioreactors III: oxygen transfer and scale-up
Material: NPTEL lectures on kLa, mixing, scale-up
Produce: kLa estimated from IndPenSim DO data
Understanding check: You can say why scale-up fails
During preparation, write one worked example connected to the week's actual task, one exercise with a separate answer key and five questions. Peter supplies answers; score explanation quality and flag misconceptions in QUESTIONS. Numeric/scientific conclusions require actual data or explicitly synthetic teaching values.
Source unit: M11 · Bayesian optimization
Material: Frazier, "A Tutorial on Bayesian Optimization" — arxiv.org/abs/1807.02811; BoTorch tutorials — botorch.org
Produce: BO on the simulator's feed profile
Understanding check: You can explain expected improvement
Use the prompt pack: P1 explanation ladder, P2 concept-to-project bridge and P3 quiz. Coding practice belongs within the allocated study/build block. Where the source asks for a favorable scientific result, substitute an honest measured comparison as explained below.
Select one verified founder/scientific-lead paper relevant to this week's domain. Use P11; save the question, method, numerical result with context, data workflow, three author questions and one connection sentence in founder-paper.md. Keep abstract-only access limitations explicit. On source weeks with no study, prioritize the commercial/submission task and log any skipped digest.
OPEN WHEN NEEDED
Branding: Draft one reporting-pattern figure with corpus-selection and extraction-error caveats.
Opportunity action: Connect a finding to one founder's published organism/process without attributing a weakness to their company.
Use career asset contracts. Publish at most the agreed cadence; one figure and one supported number or admitted failure can support multiple drafts. In long-form weeks, prepare a 1,500–2,500-word article from existing evidence within the build/buffer allocation. In release/demo weeks, prepare a 60-second script: problem, input, command/action, result, limitation and proof link.
Verify individuals, jobs and affiliations at execution time. The GridX list and v4 company map are research seeds, not current facts. Do not reveal named company weaknesses or employer/client confidential information. Keep drafted/sent/replied/booked/held statuses separate. The planning request alone does not authorize external messages or publication; honor explicit authorization in the execution session.
OPEN WHEN NEEDED
DO time series alone generally do not identify kLa without other information. The study exercise must document identifiability and assumptions or report that estimation is unsupported.
Apply the root scientific evidence contract: provenance; meaningful independent splits; no future-data leakage; baseline comparison; actual denominators/uncertainty; failed cases; human review where required. State whether data are simulated, public experimental, synthetic or partner-provided.
Keep source gates intact, and log scope/time conflicts in review. Missing people, money, access or results must not be replaced with invented evidence. Reduce optional polish first. A specific essential external dependency stays pending while independent preparation continues.
READ FIRST
This is an enabling week. Its deliverables feed the next scheduled gate: 13. Complete the acceptance checklist below; do not promote reputation from a draft.
READ FIRST
Source-preserving minimum: normalized dataset export.
Operational first step if stalled: open normalization-audit.md, write the required inputs and produce the smallest checkable example in ten minutes. If a more urgent missing gate dependency controls the week, use the source minimum above.
If the full week does not fit, use P14: retain one gate-critical deliverable and one directly supporting study exercise; record what is skipped versus moved. Do not mark the original full gate passed merely because the minimum was completed. After a missed week, reforecast from actual evidence and avoid a second unexamined lost week.
OPEN WHEN NEEDED
In review, state exactly what exists, what was verified, what Peter can now explain, which external events remain pending, where the canonical code/data live, and the next file/function or draft paragraph to touch. Link each fact to evidence. Carry scientific assumptions, split definitions and rights constraints forward explicitly.
OPEN WHEN NEEDED
Prepare Week 11 of this LABLOOP execution plan.
Read execution-plan/specs.md, execution-plan/DECISIONS.md,
execution-plan/GATES.md and
execution-plan/weeks/week-11-fermlit-dataset-engineering/specs.md, commitment.md, evidence.md and review.md.
Read prior prerequisite reviews and inspect actual repository/data state.
Use v5 as the governing sequence, the v6 Week 11 chapter
(LABLOOP-Master-Plan-v6.md) as the deeper walkthrough, and v4 only for
retained details.
Produce the full local preparation pack and the exact week-specific files named
in the artifact table. Give me a bounded lesson with exercises/answer key,
daily physical actions, technical runbook or draft, branding drafts and
career/commercial actions. Keep the total to 600 minutes.
Separate prepared artifacts from measured results and my learning completion.
Verify sources and do not invent metrics, citations, papers, people or outcomes.
Do not execute external communications, publication or spending unless the
current session already authorizes the specific action.
Finish by updating evidence/review and TODAY with the next physical action.
OPEN WHEN NEEDED
v6 reproduces this brief unchanged inside v6 · Week 11 · Dataset engineering and the reporting finding. The following is source planning text, not a claim of completion. Apply the explicit evidence corrections in this specification and DECISIONS.md.
dataset/ export.WEEK FILES
State: UNCONFIRMED. Owner: Peter Ciancaglini. Specification
Start date: not set. End date: not set. Available hours: confirm (planned ceiling 10). Primary outcome: fermlit dataset engineering. Minimum that keeps the next gate alive: normalized dataset export.
normalization-audit.md: Conversions have dimensions and assumptions; incompatible percent values are not silently converted to g/L.analysis-plan.md: Exploratory versus planned analyses are distinguished before significance claims.dataset-card-draft.md: A small reload check reproduces row counts and schema; redistribution terms are justified.| Day | Minutes | Physical action / outcome | Actual slot | Done |
|---|---|---|---|---|
| Mon | 90 | Normalize supported concentration/yield units, taxonomy identifiers and duplicates while preserving original strings and provenance. | Not set | ☐ |
| Tue | 90 | kLa estimated from IndPenSim DO data | Not set | ☐ |
| Wed | 90 | Formalize completeness questions and comparison groups; predefine effect sizes and the multiple-testing family for week 14. Last ten minutes: optional note. | Not set | ☐ |
| Thu | 90 | BO on the simulator's feed profile Include relevant founder-paper work within this block. | Not set | ☐ |
| Fri | 90 | Export versioned data and draft the dataset card, known limitations and per-source rights assessment. | Not set | ☐ |
| Sat | 90 | Resolve critical spillover; long-form draft if due; sandbox only if done. | Not set | ☐ |
| Sun | 60 | Build log, evidence, gap review, next actions. | Not set | ☐ |
Peter's commitment / adjustments: pending. Reviewing model and date: pending.
Execution state: NOT_STARTED. Specification This file is a blank register with planned artifact names; none of the rows prove completion.
| Item | Path / URL / version | State | Verification / actual result | Verified by / date |
|---|---|---|---|---|
| normalization-audit.md | Not created | NOT_STARTED | Pending: Conversions have dimensions and assumptions; incompatible percent values are not silently converted to g/L. | — |
| analysis-plan.md | Not created | NOT_STARTED | Pending: Exploratory versus planned analyses are distinguished before significance claims. | — |
| dataset-card-draft.md | Not created | NOT_STARTED | Pending: A small reload check reproduces row counts and schema; redistribution terms are justified. | — |
| Learning exercise / Peter's quiz | Not created | NOT_STARTED | Peter's actual answers required | — |
| Founder paper digest | Not created | NOT_STARTED | Source/content and access checked | — |
| Branding pack | Not created | NOT_STARTED | Claims audited; drafted/public status distinct | — |
| Opportunity actions | Not created | NOT_STARTED | Drafted/sent/replied/booked/held distinct | — |
| Question / metric | Dataset, N and unit | Split / seed / config | Command or verification method | Output path and measured value | Uncertainty / limitation |
|---|---|---|---|---|---|
| Date | Action / counterpart | Receipt or private reference | State | Next action / date |
|---|---|---|---|---|
Peter's teach-back / quiz score: not assessed. Scientific assumptions and deviations: none recorded yet. Budget allocated / spent: not assessed / no spend recorded. Missing evidence and responsible owner: pending inspection.
Do not put API keys, source full texts with restricted rights, client data or invoice personal details in a public version of this register. Keep private evidence references private.
Review status: NOT_REVIEWED. Specification · Evidence
What Peter can explain or reproduce now: not assessed. Quiz / teach-back gaps: not assessed. Measured result and limitations: pending. Best evidence link for a scientist/recruiter/buyer: pending. What failed or changed, and why: pending.
Gate requirement: No standalone gate; check this week's acceptance criteria and next gate dependencies. Gate status: NOT_STARTED. Original target week: See next gate in specs. Actual completion date / forecast: not set. Missing external evidence: pending inspection. Blocks completed / 7: not recorded. Days with commits / 7: not recorded. Sunday build log / optional Wednesday note: not recorded. Founder conversations cumulative: not recorded. Earned evidence level and proof: not assessed. Consecutive lost weeks: not assessed.
Week-specific risk to revisit: DO time series alone generally do not identify kLa without other information. The study exercise must document identifiability and assumptions or report that estimation is unsupported.
Continue / recover / blocked: not decided. Retain as the minimum: normalized dataset export. Skipped permanently with reason: none recorded. Carryover with owner, dependency and target week: none recorded. Canonical repository paths and versions: pending. Data permissions, split definitions or assumptions to preserve: pending. External action authorization that still applies: not assessed. Next physical action, exact file/function/paragraph: pending. Updates to root PROGRESS / LOG / TODAY completed: ☐
YOUR SPACE