diff --git a/.gitignore b/.gitignore index a3f6731111..522538b19b 100644 --- a/.gitignore +++ b/.gitignore @@ -29,4 +29,12 @@ tetrad-gui/bin/* tetrad-lib/bin/* /data-reader/target/ -tetrad-gui.log \ No newline at end of file +tetrad-gui.log +/testboostrap/ +/testboostrap/ +/testboostrap/CalibrationConstraintBased/ +/testboostrap/CalibrationConstraintBased/RFCI/ +/testboostrap/CalibrationConstraintBased/RFCI/RandomGraph-Vars20-Edges80-Cases1000-BS5-H0.1-a0.001/ +/testboostrap/CalibrationConstraintBased/RFCI/RandomGraph-Vars20-Edges80-Cases1000-BS5-H0.1-a0.001/BN_v20_e80_c1000_b5_-1.txt +/testboostrap/CalibrationConstraintBased/RFCI/RandomGraph-Vars20-Edges80-Cases1000-BS5-H0.1-a0.001/PAG_v20_e80_c1000_b5_-1.txt +/testboostrap/CalibrationConstraintBased/RFCI/RandomGraph-Vars20-Edges80-Cases1000-BS5-H0.1-a0.001/probs_v20_e80_c1000_b5_-1.txt diff --git a/README b/README index 78fdf67947..06dd23dd33 100644 --- a/README +++ b/README @@ -1,10 +1,10 @@ -NEWS: 7.1.0 RELEASED 2022-05-10 TO THE MAVEN CENTRAL REPOSITORY! HERE: +NEWS: 7.1.3 RELEASED 2023-01-25 TO THE MAVEN CENTRAL REPOSITORY! HERE: -https://s01.oss.sonatype.org/content/repositories/releases/io/github/cmu-phil/tetrad-gui/7.1.0/ +https://s01.oss.sonatype.org/content/repositories/releases/io/github/cmu-phil/tetrad-gui/7.1.3/ -FIXES FOR THIS RELEASE: +The Dietrich College web page for Tetrad is here (Carnegie Mellon University): -https://github.com/cmu-phil/tetrad/wiki/Fixes-for-version-7.1.0 +https://www.cmu.edu/dietrich/news/news-stories/2020/august/tetrad-sail.html This is the code for the Tetrad project. The purpose of Tetrad is to make algorithms for inferring causal relationships in data; it is a Java project @@ -23,7 +23,7 @@ The web page for the Center for Causal Discovery is here: https://www.ccd.pitt.edu/ -We have a project web page here: +We have a project web page here with all of the relevant links for code and such: https://sites.google.com/view/tetradcausal @@ -37,14 +37,6 @@ https://htmlpreview.github.io/?https:///github.com/cmu-phil/tetrad/blob/developm Javadocs can be found by running the javadocs command on the project once checked out. -Downloads directory is here: - -https://s01.oss.sonatype.org/content/repositories/releases/io/github/cmu-phil/tetrad-gui/7.1.0/ - -The wiki is here: - -https://github.com/cmu-phil/tetrad/wiki - The issue tracker is here: https://github.com/cmu-phil/tetrad/issues diff --git a/data-reader/pom.xml b/data-reader/pom.xml index efbb0b7724..b985d40b8c 100644 --- a/data-reader/pom.xml +++ b/data-reader/pom.xml @@ -5,7 +5,7 @@ io.github.cmu-phil tetrad - 7.1.2-2 + 7.1.3-1 data-reader @@ -35,7 +35,7 @@ com.fasterxml.jackson.core jackson-databind - 2.13.3 + 2.13.4.1 diff --git a/docs/manual/images/compare_box_1.png b/docs/manual/images/compare_box_1.png old mode 100755 new mode 100644 index edd9668641..33724a014f Binary files a/docs/manual/images/compare_box_1.png and b/docs/manual/images/compare_box_1.png differ diff --git a/docs/manual/images/compare_box_12.png b/docs/manual/images/compare_box_12.png new file mode 100644 index 0000000000..5cc82b143d Binary files /dev/null and b/docs/manual/images/compare_box_12.png differ diff --git a/docs/manual/images/compare_box_13.png b/docs/manual/images/compare_box_13.png new file mode 100644 index 0000000000..11b2989bdc Binary files /dev/null and b/docs/manual/images/compare_box_13.png differ diff --git a/docs/manual/images/compare_box_2.png b/docs/manual/images/compare_box_2.png deleted file mode 100755 index c40e897709..0000000000 Binary files a/docs/manual/images/compare_box_2.png and /dev/null differ diff --git a/docs/manual/images/images:compare_box_2.png b/docs/manual/images/images:compare_box_2.png new file mode 100644 index 0000000000..33724a014f Binary files /dev/null and b/docs/manual/images/images:compare_box_2.png differ diff --git a/docs/manual/index.html b/docs/manual/index.html index ae67289dcc..6ead4e4b20 100755 --- a/docs/manual/index.html +++ b/docs/manual/index.html @@ -20,8 +20,7 @@

Tetrad Manual

-

Last updated: May, 11 - 2020

+

Last updated: January, 18 2023

Graph Properties
  • Number of latent nodes
  • -
  • Number of edges
  • -
  • Number of directed edges
  • +
  • Number of adjacencies
  • +
  • Number of directed edges (not in 2-cycles)
  • Number of bidirected edges
  • Number of undirected edges
  • Max degree
  • Max indegree
  • Max outdegree
  • -
  • Cyclicity
  • +
  • Average degree
  • +
  • Density
  • +
  • Number of latents
  • +
  • Cyclic/Acyclic
  • Paths

    @@ -495,29 +497,20 @@

    Edgewise Comparisons

    it identical to the other.

    Take, for example, the following two graphs. The first is the - reference graph, the second is the graph to be compared to it.

    + reference graph, the second is the graph to be compared to it. + When the Edgewise Comparison box is opened, a comparison like this + appears:

    - - - - -

    When these two graphs are input into the graph compare box, a - window appears which allows you to specify which of the two graphs is the - reference graph. When the comparison is complete, the following window - results

    - - + +

    You may choose (by a menu in the upper left part of the box) whether the + graph being compared is the original DAG, or the CPDAG of the original + DAG, of the PAG of the original DAG

    When the listed changes have been made to the second graph, it will be identical to the first graph.

    -

    If one of the parent boxes contains multiple graphs, each graph - will be compared separately to the reference graph (or the estimated - graph will be compared separately to each reference graph, depending on - which parent box is selected as the reference), and each comparison will - be housed in its own tab, located on the left side of the window.

    Stats List Graph Comparisons

    @@ -531,6 +524,10 @@

    Stats List Graph Comparisons

    +

    You may choose (by a menu in the upper left part of the box) whether the + graph being compared is the original DAG, or the CPDAG of the original + DAG, of the PAG of the original DAG

    +

    The first columns gives an abbreviation for the statistic; the second columns gives a definition of the statistic. The third columns gives the statistic value.

    @@ -547,12 +544,7 @@

    Misclassifications

    will be a 3 in the (undirected, directed) cell of the matrix. An analogous method is used to represent endpoint errors. For example:

    - - -

    If one of the parent boxes contains multiple graphs, then each - estimated graph will be individually compared to the reference graph (or - vice versa), and the results housed in their own tab, found on the - left.

    +

    Graph Intersections

    @@ -1887,9 +1879,9 @@

    Updater independent of their causes in the graph, and probabilities for variables that are causes of the manipulated variables are unchanged.

    -

    There are five available updater algorithms in Tetrad: the - approximate updater, the row summing exact updater, the CPT invariant - updater, the Junction Tree Updater, and the SEM updater. All except for +

    There are four available updater algorithms in Tetrad: the + approximate updater, the row summing exact updater, and the Junction Tree Updater, + and the SEM updater. All except for the SEM updater function only when given Bayes instantiated models as input; the SEM updater functions when given a SEM instantiated model as input. None of the updaters work on cyclic models.

    @@ -2019,13 +2011,13 @@

    Row Summing Exact Updater

    see conditional as well as marginal probabilities, and in “Single Variable” mode, you can see joint values.

    -

    CPT Invariant Exact Updater

    + -

    The CPT invariant exact updater is more accurate than the - approximate updater, but slightly faster than the row summing exact - updater. Ifs window functions exactly as the approximate updater down, - with one exception: in “Multiple Variables” mode, you can see conditional - as well as marginal probabilities.

    + + + + +

    Junction Tree Exact Updater

    @@ -2328,6 +2320,12 @@
    Random Forward DAG
    specify graph parameters such as number of variables, maximum and minimum degrees, and connectedness.

    +
    Erdos Renyi DAG
    + +

    This option creates a DAG by randomly adding edgew with a given edge + probability. The graph is then oriented as a DAG by choosing a + causal order.

    +
    Scale Free DAG

    This option creates a DAG whose variable’s degrees obey a power @@ -2580,7 +2578,10 @@

    Using the Search Box

    the search.

    After optionally changing any search parameters, click on "Run - Search and Generate Graph" which will execute the search

    + Search and Generate Graph" which will execute the search.

    + +

    Notably there are some experimental algorithms available in this box. + To see these, select File->Settings->Enable Experimental.

    Search Algorithms

    @@ -2844,46 +2845,46 @@

    Parameters

    verbose meekVerbose

    -

    The IMaGES Discrete Algorithm (BDeu Score)

    + -

    Description

    + -
    + -

    Adjusts the discrete BDeu variable score of FGES so allow for - multiple datasets as input. The BDeu scores for each data set are - averaged at each step of the algorithm, producing a model for all - data sets that assumes they have the same graphical structure across - dataset. Note that in order to use this algorithm in a nontrivial - way, one needs to have loaded or simulated multiple dataset.

    + + + + + + -
    + -

    Input Assumptions

    + -

    A set of discrete datasets with the same variables and sample - sizes.

    + + -

    Output Format

    + -

    A CPDAG, interpreted as a common model for all datasets.

    + -

    Parameters

    + -

    All of the parameters from FGES are available for IMaGES. - Additionally:

    + + -

    numRuns, randomSelectionSize

    + + -

    The IMaGES Continuous Algorithm (SEM BIC Score)

    +

    The IMaGES Algorithm

    Description

    -

    Adjusts the continuous variable score (SEM BIC) of FGES so +

    Adjusts the selected score for FGES so allow for multiple datasets as input. The linear, Gaussian BIC scores for each data set are averaged at each step of the algorithm, producing a model for all data sets that assumes they have the same @@ -2893,7 +2894,7 @@

    Description

    Input Assumptions

    -

    A set of continuous datasets with the same variables and sample +

    A set of datasets consistent with the chosen score with the same variables and sample sizes.

    Output Format

    @@ -3030,52 +3031,52 @@

    Parameters

    href="#completeRuleSetUsed">completeRuleSetUsed

    -

    The RFCI-BSC Algorithm

    + -

    Description

    + -
    + -

    RFCI-BSC is a combination of the RFCI [Colombo, 2012] - algorithm and the Bayesian Scoring of Constraints (BSC) method - [Jabbari, 2017] that can generate and probabilistically score - multiple models, outputting the most probable one. This search - algorithm is a hybrid method that derives a Bayesian probability that - the set of independence tests associated with a given causal model - are jointly correct. Using this constraint-based scoring method, we - are able to score multiple causal models, which possibly contain - latent variables, and output the most probable one. See [Jabbari, - 2017].

    + + + + + + + + + + -

    Currently, this algorithm can only be accessed if experimental - algorithms are activated. One may do so by going to the - File menu, selecting Settings, and then making sure the - 'Experimental' checkbox is checked.

    + + + + -
    + -

    Input Assumptions

    + -

    The data are discrete only.

    + -

    Output Format

    + -

    A partial ancestral graph (PAG). See Spirtes et al., 2000.

    + -

    Parameters

    + -

    All of the parameters from RFCI are available for RFCI-BSC. - Additionally:

    + + -

    numRandomizedSearchModels, thresholdNoRandomDataSearch, cutoffDataSearch, thresholdNoRandomConstrainSearch - , cutoffConstrainSearch, numBscBootstrapSamples, lowerBound, upperBound, - outputRBD

    + + + + + + + + +

    The GFCI Algorithm

    @@ -3370,13 +3371,13 @@

    Parameters

    targetName

    -

    The MBFS Algorithm

    +

    The PC-MB Algorithm

    Description

    -
    +
    -

    Markov blanket fan search. Similar to FGES-MB (see FGES, +

    PC-MB. Similar to FGES-MB (see FGES, 2016) but using PC as the basic search instead of FGES. The rules of the PC search are restricted to just the variables in the Markov blanket of a target T, including T; the result is a graph that is a @@ -4353,7 +4354,7 @@

    Parameters

    Search Parameters

    Note: You must specify the "Value Type" of each parameter, and - the value type must be one of the following: Integer, Double, String, + the value type must be one of the following: Integer, Long, Double, String, Boolean.

    @@ -4598,13 +4599,13 @@

    coefLow

    id="completeRuleSetUsed_short_desc"> Yes if the complete FCI rule set should be used
  • Long Description: Yes if the (simpler) final + id="completeRuleSetUsed_long_desc"> No if the (simpler) final orientation rules set due to P. Spirtes, guaranteeing arrow - completeness, should be used; no if the (fuller) set due to J. Zhang, + completeness, should be used; yes if the (fuller) set due to J. Zhang, should be used guaranteeing additional tail completeness.
  • Default Value: false
  • + id="completeRuleSetUsed_default_value">true
  • Lower Bound:
  • Upper Bound: coefLow
  • Boolean +

    doDiscriminatingPathRule

    + + +

    doDiscriminatingPathColliderRule

    + + +

    doDiscriminatingPathTailRule

    + +

    concurrentFAS

    targetNames

    - +

    mb

    + +

    discretize

    +

    imagesMetaAlg

    + +

    ia

    -

    zsMaxIndegree

    -

    bossScoreType

    + id="bossAlg">bossAlg

    numStarts

    graspUseVermaPearl

    + id="graspUseRaskuttiUhler">graspUseRaskuttiUhler

    precomputeCovarianc id="penaltyDiscount_value_type">Double +

    zSRiskBound

    + +

    ebicGamma

    -

    zSRiskBound

    - -

    correlationThreshold

    @@ -7663,6 +7745,25 @@

    sampleSize

    Type: Integer +

    seed

    + +

    selfLoopCoef

    +

    poissonLambda

    + +

    skipNumRecords