Skip to content

Commit 3557c4b

Browse files
committed
Updated with more breadcrumbs
1 parent 47de515 commit 3557c4b

1 file changed

Lines changed: 80 additions & 3 deletions

File tree

project/readme.md

Lines changed: 80 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -28,8 +28,85 @@ Those directories that start with 00 are direct copies (a white lie) of modules
2828

2929
# General Comments About This Project
3030

31-
This project is built from framework-legacy, a suite of functionality, that, itself is built upon [UIMA](https://uima.apache.org/) 2.9. Framework-legacy is an evolution of [V3-NLP Framework](https://pubmed.ncbi.nlm.nih.gov/27683667/); which was built specifically for use within the Veteran Administration's [VINCI environment](https://www.hsrd.research.va.gov/for_researchers/vinci/workspace.cfm) to process, at scale, VA clinical documents.
31+
This project is built from java-nlp-framework, a suite of functionality, that, itself is built upon [UIMA](https://uima.apache.org/) 2.9. Framework-legacy is an evolution of [V3-NLP Framework](https://pubmed.ncbi.nlm.nih.gov/27683667/); which was built specifically for use within the Veteran Administration's [VINCI environment](https://www.hsrd.research.va.gov/for_researchers/vinci/workspace.cfm) to process, at scale, VA clinical documents.
3232

33-
Note: framework-legacy relies upon [uimaFIT](https://uima.apache.org/uimafit.html), to define the pipelines in code rather than through the myriad of configuration files. You will not find the UIMA configuration files in the above projects, except to retrofit and work with other UIMA based tools.
33+
Note: java-framework relies upon [uimaFIT](https://uima.apache.org/uimafit.html), to define the pipelines in code rather than through the myriad of configuration files. You will not find the UIMA configuration files in the above projects, except to retrofit and work with other UIMA based tools.
3434

35-
This project is built using Maven and Java. Maven reactors should kick off the cascade of sub-projects to be made.
35+
This project is built using Maven and Java. Maven reactors should kick off the cascade of sub-projects to be made.
36+
37+
Note: See [Java-NLP-Framework/readme.md](https://github.com/CC-RMD-EpiBio/java-nlp-framework#readme) for details.
38+
39+
40+
## The Jars Compiled from Java-NLP-Frameowrk distributed within this Repo
41+
The following jars are distributed here (we do not have a nexus service to host these directly). As part of the build, these jars get locally installed into your *.m2* directory as part of the 00_2_framework-jars project called from the reactor pom.
42+
43+
- 01-nlp-resources-2022.09.0.jar
44+
- 03-nlp-type-descriptors-2022.09.0.jar
45+
- 04.0-nlp-util-2022.09.0.jar
46+
- 04.1-nlp-vUtil-2022.09.0.jar
47+
- 05-nlp-annotators-2022.09.0.jar
48+
- 06-nlp-marshallers-2022.09.0.jar
49+
- 07.0-nlp-pUtils-2022.09.0.jar
50+
- 08-nlp-pipelines-2022.09.0.jar
51+
52+
## Third Party Software and Jars Also Not Distributed via a Nexus Service
53+
This project, when built from this repo, relies on a few jars that cannot be found via a nexus service. They are found within the 00_1_ThirdParty-Jars project and are built from the reactor pom.
54+
55+
# Building
56+
For reference sake, $BF_HOME equates to where this repo got cloned out then changed to the ./project directory.
57+
58+
Install the parent,parent pom first. This is the pom in $BF_HOME/00_0_parent. This parent pom is a copy of the Java-NLP-Framework's parent pom. All is built upon the Java-NLP-Framework, so referencing that project's parent pom is a must.
59+
(Skip this if you've prior installed the Java-NLP-Framework project).
60+
<pre>
61+
cd $BF_HOME
62+
cd 00_0_parent
63+
mvn install
64+
cd ..
65+
</pre>
66+
67+
Once Java-NLP-Framework's parent pom has been installed, there is a Body Function parent pom to install.
68+
<pre>
69+
cd $BF_HOME
70+
cd 60_01_parent
71+
mvn install
72+
cd ..
73+
</pre>
74+
75+
Once the Body Function parent pom has been installed, go back and build the set of projects. There is a reactor pom in the $BF_HOME directory that refers to each project to be built.
76+
77+
78+
### Example Build from the command line:
79+
80+
> cd $BF_HOME
81+
> mvn install
82+
83+
</pre>
84+
When the process is complete, the output from the process should look something like this:
85+
<pre>
86+
[INFO]
87+
[INFO] ----------< gov.nih.cc.rmd.framework:60_00-bodyFunction-Top >-----------
88+
[INFO] Building 60_00-bodyFunction-Top 2022.09.0 [10/10]
89+
[INFO] --------------------------------[ pom ]---------------------------------
90+
[INFO]
91+
[INFO] --- maven-install-plugin:2.4:install (default-install) @ 60_00-bodyFunction-Top ---
92+
[INFO] Installing [somePath]\bodyFunction\project\pom.xml to [somePath]\[M2_Repository]\gov\nih\cc\rmd\framework\60_00-bodyFunction-Top\2022.09.0\60_00-bodyFunction-Top-2022.09.0.pom
93+
[INFO] ------------------------------------------------------------------------
94+
[INFO] Reactor Summary for 60_00-bodyFunction-Top 2022.09.0:
95+
[INFO]
96+
[INFO] unmavenedJars ...................................... SUCCESS [ 3.650 s]
97+
[INFO] 02-thirdParty ...................................... SUCCESS [ 0.025 s]
98+
[INFO] 00_framework-jars .................................. SUCCESS [ 0.932 s]
99+
[INFO] gov.nih.cc.rmd.framework: 60_01-bodyFunction-parent SUCCESS [ 0.050 s]
100+
[INFO] 60_01_bodyFunction_resources ....................... SUCCESS [ 0.763 s]
101+
[INFO] 60_03-bodyFunction-type-descriptors ................ SUCCESS [ 59.392 s]
102+
[INFO] 60_05-bodyFunction-annotators ...................... SUCCESS [ 6.332 s]
103+
[INFO] 60_08-bodyFunction-pipelines ....................... SUCCESS [ 7.337 s]
104+
[INFO] 60_09-bodyFunction-Application ..................... SUCCESS [02:58 min]
105+
[INFO] 60_00-bodyFunction-Top ............................. SUCCESS [ 0.045 s]
106+
[INFO] ------------------------------------------------------------------------
107+
[INFO] BUILD SUCCESS
108+
[INFO] ------------------------------------------------------------------------
109+
[INFO] Total time: 04:17 min
110+
[INFO] Finished at: 2022-08-18T18:19:28-04:00
111+
[INFO] ------------------------------------------------------------------------
112+
</pre>

0 commit comments

Comments
 (0)