diff --git a/docs/index.html b/docs/index.html deleted file mode 100644 index 14bf3d4..0000000 --- a/docs/index.html +++ /dev/null @@ -1,15557 +0,0 @@ - - - - - - - - - -presentation slides - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - - - - - - - - - - diff --git a/docs/presentation.html b/docs/presentation.html new file mode 100644 index 0000000..c3c0295 --- /dev/null +++ b/docs/presentation.html @@ -0,0 +1,2612 @@ + + + + + + + + + + + + + + + + Reproducibility Standards in Economics (and beyond) + + + + + + + + + + + + + + + +
+
+ +
+

Reproducibility Standards in Economics (and beyond)

+

JHU FOSSProF Summative Event

+ +
+
+
+Alan Lujan +
+
+alujan@jhu.edu +
+

+ Johns Hopkins University AAP +

+
+
+
+Chris Carroll +
+
+ccarroll@jhu.edu +
+

+ Johns Hopkins University +

+
+
+ +

October 7, 2024

+
+
+

REMARK Motivation

+
    +
  • Econ lags in reproducibility practices
    • +
  • State of field: for published papers +
      +
    • .zip archive has some files +
        +
      • rarely works ‘out of the box’
        • +
      • +
    • Top-5 journals have a ‘data editor’ +
        +
      • Very expensive
        • +
      • Excellent barrier to competition
        • +
      • +
    • +
+
+
+

Econ-ARK REMARK solutions

+
    +
  • Standards for reproducibility of compute +
      +
    • self-contained and complete projects
      • +
    • executable on any modern computer
      • +
    • +
  • Emphasis on: +
      +
    • minimally good code +
        +
      • enforced algorithmically
        • +
      • would be huge improvement
        • +
      • “ChatGPT, fix my documentation”
        • +
      • +
    • explicit claims (“Risk Aversion: [2.5,3.5]”)
      • +
    • standardized metadata
      • +
    • +
+
+
+

REMARK Library: About 23+3

+ +
+
+

Jointly Reproducible: Code and Math and Text

+
    +
  • Solved: most computational aspects +
    • +
+
+
+

Math and Text with Code?

+
    +
  • LaTeX is standard for text, but… +
      +
    • definitely not lightweight
      • +
    • no dynamically executable content
      • +
    • +
  • Now: tenuous connection between text and code +
      +
    • “where is equation 18 implemented”? +
        +
      • in a gestalt of interactions
        • +
      • +
    • +
  • Future: +
    • +
+
+
+

FOSSProF \(\rightarrow\) Curvenote

+

Funding let us hire open source contractor - To do things we could not do

+

At our direction:

+
    +
  • Integrated MyST Markdown into REMARK
    • +
  • Filled gaps in tools to integrate text, math, and code
    • +
  • Improved LaTeX \(\rightarrow\) MyST engine +
      +
    • Tools required for some of our REMARKs
      • +
    • +
+
+
+

Curvenote: \(\LaTeX\)

+ +
+
+

Curvenote: Computation

+ +
+
+

Journal of Open Source Economics

+

+
+
+

Not Specific to Economics!

+
    +
  • conceived for projects using Econ-ARK +
      +
    • … but doesn’t require Econ-ARK
      • +
    • +
  • Not bound to economics in any way
    • +
+
+
+

Rebranding: REMARK \(\rightarrow\) SCI-PASS

+
    +
  • Scholarly Communication Infrastructure for Publishing and Archiving Scientific Software
    • +
  • Ambition: +
      +
    • universal standard for repr compute +
        +
      • nothing now exists (we’ve looked)
        • +
      • +
    • +
  • Also short for “scientific passport” +
      +
    • portability/sharing of research outputs
      • +
    • +
+
+
+

Long-Term Goal: ISO standard

+
    +
  • Adoptable by journals, libraries, archives …
    • +
  • Existing software standards got started this way +
      +
    • Somebody needed it for their own purposes
      • +
    • +
  • Members of our team: +
      +
    • SB: “Information Science” PhD +
        +
      • connection to archivists, librarians
        • +
      • +
    • AS: Economics PhD +
        +
      • Vetted ISO software standards for Oz
        • +
      • +
    • +
+
+
+ +
+
+
+
+
+ + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/presentation.ipynb b/presentation.ipynb index 1511ed9..9830094 100644 --- a/presentation.ipynb +++ b/presentation.ipynb @@ -11,15 +11,7 @@ "tags": [] }, "source": [ - "\n", - "

Reproducibility Standards

\n", + "

Reproducibility Standards

\n", "

in Economics (and beyond)

\n", "

JHU FOSSProF Summative Event

\n", "
October 7, 2024
\n", @@ -52,7 +44,7 @@ " margin: 0 !important;\n", "}\n", "\n", - "# [REMARK](https://github.com/econ-ark/REMARK) Motivation\n", + "# [REMARK](https://github.com/econ-ark/REMARK?tab=readme-ov-file#replicationseproductions-and-explorations-made-using-ark-remark) Motivation\n", "\n", "- Econ lags in reproducibility practices\n", "- State of field: for _published_ papers\n",