Difference between revisions of "BioPortal Release Notes"

From NCBO Wiki
Jump to navigation Jump to search
(Noted that this page is no longer used, in favor of GitHub releases. Added links to release notes pages for API and UI.)
 
(43 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 +
'''<span style="color:red;">Please note: this page is deprecated and no longer updated. To view current release notes for BioPortal, please refer to one of the following pages:</span>'''
 +
 +
BioPortal REST API release notes: https://github.com/ncbo/ontologies_api/releases<br>
 +
BioPortal web application release notes: https://github.com/ncbo/bioportal_web_ui/releases
 +
 +
 +
''This page contains software release notes for the 5.x series of [http://bioportal.bioontology.org/ BioPortal].'' 
 +
 +
Use the following links to access release notes for the BioPortal Virtual Appliance, and older versions of BioPortal:
 +
 +
* [[BioPortal_Virtual_Appliance_Release_Notes|BioPortal Virtual Appliance release notes]]
 +
* [[BioPortal_4_Release_Notes|BioPortal 4.x release notes]]
 +
* [[BioPortal_Release_3_Release_Notes|BioPortal 3.x release notes]]
 +
* [[BioPortal_Release_2_Release_Notes|BioPortal 2.x release notes]]
 +
 +
 
__TOC__
 
__TOC__
  
== BioPortal Release 4.29 (Oct 2016) ==
 
  
* Loaded 2016AA and 2016AB versions of the UMLS terminologies into BioPortal (NCBO-1772, NCBO-1711).
+
== BioPortal 5.22.1 (2021-July-08, 2021-August-10) ==
* Fixed an issue on the BioPortal home page that prevented the Facebook Like button and Cite Us link from working (NCBO-1746).
 
* Fixed a bug in the Recommender algorithm that caused NCIT to always show up as the recommended ontology (NCBO-1794).
 
* Fixed a bug that prevented the annotation process from succeeding during parsing of the ECSO ontology (NCBO-1813).
 
* Performed software upgrades for the BioPortal application and REST endpoint:
 
** Rails 4.2.6 (NCBO-1759)
 
** Ruby 2.2.5 (NCBO-1782)
 
* Fixed parsing issues for the following ontologies:
 
** AAO (NCBO-1690)
 
** ATMO (NCBO-1783)
 
** BCTTV1 (NCBO-1700)
 
** BT (NCBO-1786)
 
** BTO (NCBO-1787)
 
** CHEBI (NCBO-1780)
 
** CIINTEADO (NCBO-1702
 
** CISAVIADO (NCBO-1698)
 
** EFO (NCBO-1788)
 
** ENVO (NCBO-1791)
 
** HAROREADO, HAAURAADO (NCBO-1695)
 
** MOOCCUADO, MOOCCIADO, MOOCULADO (NCBO-1688)
 
** MS (NCBO-1579)
 
** ORDO (NCBO-1771)
 
** PHMAMMADO, PHFUMIADO (NCBO-1692)
 
** RNAO (NCBO-1795)
 
  
== BioPortal Release 4.28 (June 2016) ==
+
'''Bug Fixes'''
  
* Modified several areas of code to eliminate long running SPARQL count queries that hampered overall performance (NCBO-1741).
+
* Fixed a bug that caused Mapping Submission IDs query to fail in AllegroGraph ([https://github.com/ncbo/ontologies_linked_data/issues/120 ncbo/ontologies_linked_data#120])
* Tweaked the size of cache limits to ensure that frequently requested data is cached appropriately (NCBO-1757).
+
* Fixed a bug that prevented UMLS ontologies from being processed in AllegroGraph ([https://github.com/ncbo/bioportal-project/issues/215 ncbo/bioportal-project#215])
* Fixed an issue that prevented the BioPortal site from setting correct HTTP status codes for Internal Server and Not Found errors. Previously, BioPortal always set status codes to 200 (NCBO-1548).
+
* Fixed a security vulnerability
* Fixed an issue that prevented the Sequence Types and Features Ontology (SO) ontology from parsing (NCBO-1739).
 
* Cleaned up and removed 249 failed submissions of the GoMapMan (GMM) ontology that resulted from an invalid ontology pull location (NCBO-1743).
 
  
  
== BioPortal Release 4.27 (May 2016) ==
+
== BioPortal 5.21.0 (2021-May-18) ==
  
* Made improvements to the code that calculates ontology popularity, which is the default sort order for search results in BioPortal (NCBO-1718).
+
'''New Features'''
* Modified the code that calculates ontology metrics to reduce occurrences of long running SPARQL count queries (NCBO-1652, NCBO-1724, NCBO-1736).
 
* BioPortal will now display preferred names with English ("en") language tags by default.  Previously, preferred names were chosen at random without regard to language tags (NCBO-1662).
 
* Upgraded to Java 8 (NCBO-1697).
 
* Fixed an issue that prevented the PE-O ontology from parsing correctly (NCBO-1716).
 
* Fixed an issue that prevented the PHENX ontology from parsing correctly (NCBO-1708).
 
* Removed assets from BioPortal home page from non HTTPS sources, which caused browsers to report BioPortal as an insecure site (NCBO-1567).
 
* Fixed corrupt creation dates for a number of projects on the Projects page (NCBO-1535).
 
  
 +
* Further optimize the mapping counts generation job, including periodic 4store health checks ([https://github.com/ncbo/ncbo_cron/issues/40 ncbo/ncbo_cron#40])
 +
* Added incremental progress logging to the Annotator dictionary generation job ([https://github.com/ncbo/ncbo_annotator/issues/16 ncbo/ncbo_annotator#16])
  
== BioPortal Release 4.26 (April 2016) ==
+
'''Bug Fixes'''
* Upgraded to version 4.2.1 of the OWL API (NCBO-1676).
 
* Generated metrics data for a number of ontologies with missing metrics (NCBO-1687).
 
* Reparsed the FMA ontology to fix an issue with missing values for preferred labels, synonyms, and definitions (NCBO-1679).
 
* Fixed an issue that caused parsing errors with the latest versions of the NCIT ontology (NCBO-1664).
 
* Fixed a bug in the Recommender's score aggregation function for ontology sets (NCBO-1682).
 
* Fixed an issue with the PO ontology that resulted in a series of bad submissions and failed indexing (NCBO-1678).
 
* Fixed an issue that prevented the MS ontology from parsing correctly (NCBO-1579).
 
  
 +
* Fixed the 4store health status check API ([https://github.com/ncbo/goo/issues/112 ncbo/goo#112])
  
== BioPortal Release 4.25 (March 2016) ==
 
  
In this release we fixed problems that were causing regular outages of the [[BioPortal_Help#Recommender_Tab|Recommender]], and sometimes affecting the main BioPortal system. Our troubleshooting documentation has been updated based on our experience.
+
== BioPortal 5.20.0 (2021-April-02) ==
  
* Fixed an issue that prevented users from getting "ready" submissions from the REST API (NCBO-1673)
+
'''New Features'''
* Fixed an issue that caused the Metrics REST endpoint to fail (NCBO-1660).
 
* Flattened and reparsed the DRON ontology to address SPARQL query performance issues (NCBO-1651).
 
* Fixed a bug that caused the Recommender to fail when dealing with ontologies with no submissions (NCBO-1650).
 
* Modified several BioPortal components to retrieve ontology class counts from metrics data instead of directly querying the backend to address performance issues (NCBO-1648).
 
* Fixed an issue was preventing the latest versions of the NCIT ontology from being pulled into BioPortal (NCBO-1655).
 
  
 +
* A new CRON job that allows regenerating total mapping count and mapping count pairs on demand ([https://github.com/ncbo/ncbo_cron/issues/37 ncbo/ncbo_cron#37])
 +
* An enhancement to the ontology pull process to allow clearing caches after the full run ([https://github.com/ncbo/ncbo_cron/issues/38 ncbo/ncbo_cron#38])
  
== BioPortal Release 4.24 (February 2016) ==
+
'''Bug Fixes'''
 +
 
 +
* The mapping counts generation script failed to properly count mappings between ontoloigies ([https://github.com/ncbo/ontologies_linked_data/issues/88 ncbo/ontologies_linked_data#88])
 +
* Reported mapping counts between ontologies are always higher than the actual counts ([https://github.com/ncbo/ontologies_linked_data/issues/115 ncbo/ontologies_linked_data#115])
 +
* Incorrect mapping count statistics generated for some ontologies ([https://github.com/ncbo/ontologies_linked_data/issues/94 ncbo/ontologies_linked_data#94])
 +
* Empty pages in paged result sets ([https://github.com/ncbo/ontologies_linked_data/issues/66 ncbo/ontologies_linked_data#66])
 +
 
 +
 
 +
== BioPortal 5.19.0 (2020-September-04) ==
  
'''Enhancements'''
+
'''New Features'''
  
* Implemented an ability to create and manage provisional relations on a provisional class (NCBO-1614)
+
* A new CRON job that synchronizes the search index with the master data stored in the triple store ([https://github.com/ncbo/ncbo_cron/issues/34 ncbo/ncbo_cron#34])
* Implemented an ability to search for all subclasses of a class, including provisional classes (NCBO-1624)
+
* An enhancement to the test runner script that uses a Dockerized instance of Redis for the tests run against
  
 
'''Bug Fixes'''
 
'''Bug Fixes'''
  
* Fixed a subtree root search to properly include provisional classes when an appropriate parameter is passed to the endpoint
+
* A fix to the test runner script that detects when a test fails instead of always reporting SUCCESS ([https://github.com/ncbo/ontologies_linked_data/issues/111 ncbo/ontologies_linked_data#111])
* Fixed an issue with CHEBI ontology not being pulled from its download location (NCBO-1639)
+
* Fixed a bug that prevented the ontologies report refresh from completing successfully ([https://github.com/ncbo/ncbo_cron/issues/35 ncbo/ncbo_cron#35])
* Fixed a display issue where BioPortal displayed a nested 404 page when an error occured rendering the class tree (NCBO-1623)
+
 
* Fixed a bug in NCBO Tree widget that ommitted a "+" sign for classes that have children (NCBO-1574)
+
 
* Fixed an issue with search not returning entries for some existing classes of NCBI Taxonomy (NCBITAXON) (NCBO-1591)
+
== BioPortal 5.18.0 (2020-July-14) ==
* Added sample link to this section of the API documentation (NCBO-1612)
+
 
* Updated the Resource Index UI to default to hierarchical classes (classes and descendants) (NCBO-1622)
+
'''New Features'''
* Fixed a broken pull location for ONLIRA ontology (NCBO-1627)
 
  
 +
* Upgraded OWL API to version 4.5.17; updated the OWL API Wrapper to reflect this upgrade ([https://github.com/ncbo/owlapi_wrapper/releases/tag/v1.3.6 owlapi_wrapper/releases/tag/v1.3.6])
 +
* In OWL API Wrapper, expanded the list of allowed suffixes for ontology files to include .n3, .nt, .nq, .skos, .rdf, and .rdfs ([https://github.com/ncbo/owlapi_wrapper/releases/tag/v1.3.6 owlapi_wrapper/releases/tag/v1.3.6])
 +
* Implemented a script to allow an on-demand regenerating of the ontology admin report ([https://github.com/ncbo/ncbo_cron/issues/32 ncbo/ncbo_cron#32])
 +
* Implemented a script to allow an on-demand regenerating of the ontology analytics data ([https://github.com/ncbo/ncbo_cron/issues/19 ncbo/ncbo_cron#19])
 +
* Implemented a script to allow an on-demand regenerating of the ontology rank data ([https://github.com/ncbo/ncbo_cron/issues/31 ncbo/ncbo_cron#31])
  
== BioPortal Release 4.23 (January 2016) ==
+
'''Bug Fixes'''
  
* Added an additional server to the group that serves the BioPortal UI for improved performance.
+
* Fixed a deprecation warning `Redis#exists(key)` will return an Integer in redis-rb 4.3 ([https://github.com/ncbo/sparql-client/issues/3 ncbo/sparql-client#3], [https://github.com/ncbo/ncbo_annotator/issues/12 ncbo/ncbo_annotator#12])
* Fixed an issue with the ontology analytics REST endpoint returning an empty set.
 
* Fixed an issue that caused a breakage of the ontology submissions REST endpoint (NCBO-1590).
 
* Fixed an issue that prevented search from returning some terms in the DOID and NCBITAXON ontologies (NCBO-1578, NCBO-1588).
 
* Fixed an issue that caused some of the mapping display dialogs to freeze (NCBO-1562).
 
* Fixed an issue where using the "Jump To:" search box on the ontology classes page caused the UI to hang (NCBO-1506).
 
* Fixed an issue that prevented the DDO ontology from parsing (NCBO-1603).
 
* Fixed an issue that caused an error in the virtual appliance if ontology analytics data is empty.  Thanks to Vincent Emonet for the contribution.
 
* Fixed an issue on the Annotator page with an incorrect parameter in the REST API link to retrieve results formatted as JSON.  Thanks (again!) Vincent Emonet for the contribution.
 
  
  
== BioPortal Release 4.22.1 (December 2015) ==
+
== BioPortal 5.17.0 (2020-June-22) ==
  
This is a minor release that addresses an issue of system instability caused by a bug in our HTTP caching layer that resulted in a significant load on our backend services.
+
'''New Features'''
  
'''Enhancements'''
+
* Implemented the ability to retrieve sorted ontology classes via the search endpoint ([https://github.com/ncbo/bioportal_project/issues/165 ncbo/bioportal_project#165]). The API signature is as follows:<br/>http://data.bioontology.org/search?ontologies=NCIT&sort=prefLabel
 +
* Implemented the ability to retrieve sorted descendant classes via the subtree search endpoint ([https://github.com/ncbo/bioportal_project/issues/165 ncbo/bioportal_project#165]). The API signature is as follows:<br/>http://localhost:9393/search?subtree_ontology=NCIT&subtree_root_id=http%3A%2F%2Fncicb.nci.nih.gov%2Fxml%2Fowl%2FEVS%2FThesaurus.owl%23C16275&sort=prefLabel
 +
* Implemented a test runner script that uses Dockerized versions of 4store and AllegroGraph to run the test suite. The triple store backends and their versions can now be switched seamlessly when running unit tests ([https://github.com/ncbo/ontologies_linked_data/issues/105 ncbo/ontologies_linked_data#105])
 +
<pre>
 +
Usage: bundle exec ruby run_tests.rb [options]
  
* Added configuration parameters at the UI layer that allow for a greater control over debugging issues with HTTP caching.
+
    -b, --backend [4store|ag]        An optional backend name. Default: 4store
 +
    -v, --version VERSION            An optional version of the server to test against. Default: 'latest'
 +
    Must be a valid image tag published on repositories:
 +
https://hub.docker.com/r/bde2020/4store/tags for 4store
 +
https://hub.docker.com/r/franzinc/agraph/tags for ag
 +
    -p, --port PORT                  An optional port number of the server to test against. Default: 9000 for 4store, 10035 for ag
 +
    Must be a valid integer value
 +
    -f, --file TEST_FILE_PATH        An optional path to a test file to be run. Default: all test files
 +
    -t, --test TEST_NAME            An optional name of the test to be run. Default: all tests
 +
    -h, --help                      Display this screen
 +
</pre>
  
 
'''Bug Fixes'''
 
'''Bug Fixes'''
  
* Fixed a bug in the HTTP caching code that caused multiple identical requests to bypass the cache and trigger extraneous requests to the REST API. The bug fix resulted in a significant performance boost to both the front- and back-end services.
+
* Fixed an issue running against AllegroGraph v7+ that prevented paged calls from completing properly ([https://github.com/ncbo/goo/issues/106 ncbo/goo#106])
 +
* Fixed an issue running against AllegroGraph v7+, where a test for ontology properties failed ([https://github.com/ncbo/ontologies_linked_data/issues/106 ncbo/ontologies_linked_data#106])
 +
* Fixed an issue that caused Zlib::GzipWriter runtime errors during ontology processing ([https://github.com/ncbo/ontologies_linked_data/issues/107 ncbo/ontologies_linked_data#107])
 +
* Removed a workaround that was implemented to address a bug in AllegroGraph v6+, which caused certain SPARQL queries to fail. AllegroGraph v7.0.1 release has addressed the issue ([https://github.com/ncbo/goo/issues/104 ncbo/goo#104])
 +
* Fixed an issue that caused runtime errors when running the code against Ruby 2.7.0 and Ruby 2.7.1 ([https://github.com/ncbo/ontologies_api/issues/69 ncbo/ontologies_api#69])
 +
* Fixed an issue, where a search on term id with exact match returns irrelevant results ([https://github.com/ncbo/ontologies_api/issues/57 ncbo/ontologies_api#57])
 +
* Fixed an issue, where a call to the class descendants endpoint fails if properties are included ([https://github.com/ncbo/ontologies_api/issues/54 ncbo/ontologies_api#54])
  
  
== BioPortal Release 4.22 (November 2015) ==
+
== BioPortal 5.16.0 (2020-April-16) ==
  
'''Enhancements'''
+
'''New Features'''
  
* New functionality at the REST API level in support of our collaboration with the [http://www.metadatacenter.org/ CEDAR] project:
+
* Full integration with the AllegroGraph Semantic Graph Database; 4store backwards compatibility assured ([https://github.com/ncbo/bioportal_project/issues/122 ncbo/bioportal_project#122], [https://github.com/ncbo/goo/issues/100 ncbo/goo#100])
** Added the ability to search for, and retrieve all value sets.
 
** Implemented search for value set items ([http://data.bioontology.org/search?q=melanoma&also_search_provisional=true&valueset_exclude_roots=true&ontology_types=VALUE_SET_COLLECTION example link]).
 
** Implemented search for ontology classes and value set items ([http://data.bioontology.org/search?q=melanoma&also_search_provisional=true&valueset_exclude_roots=true example link]).
 
** Added the ability to exclude value set collections from search ([http://data.bioontology.org/search?q=melanoma&ontology_types=ONTOLOGY&also_search_provisional=true example link]).
 
** Added the ability to search for value set values across all value sets in an ontology.
 
* Ontologies are now sortable by creation date on the Admin page.
 
* Clicking the Add Comment and/or Add Proposal buttons in the Notes sections for ontologies will navigate unauthenticated users to the login page.
 
  
 
'''Bug Fixes'''
 
'''Bug Fixes'''
  
* Fixed an issue that caused [http://bioportal.bioontology.org/projects Projects page] load times in excess of 3 minutes.
+
* Fixed an issue with AllegroGraph request chain breaking with existing Goo code ([https://github.com/ncbo/goo/issues/101 ncbo/goo#101])
* Fixed an issue that caused the UI to go blank after selecting the root node of the CCO ontology.
+
* Fixed an issue, where no parsed ontology records appeared in AllegroGraph after ontology has been parsed ([https://github.com/ncbo/goo/issues/102 ncbo/goo#102])
* Admin page: the ontologies table now refreshes after deleting an ontology.
+
* Fixed an issue with the paging calls returning wrong results in AllegroGraph ([https://github.com/ncbo/goo/issues/103 ncbo/goo#103])
* Fixed an issue that caused a 404 error when trying to view the DINTO ontology.
 
* Fixed an inconsistency in the metadata for the CHMO ontology that caused the parsing process to fail.
 
  
  
== BioPortal Release 4.21 (October 2015) ==
+
== BioPortal 5.14.0 (2019-December-09) ==
  
'''Bug Fixes'''
+
* Implemented a number of enhancements that drastically improved performance of the class descendants call ([https://github.com/metadatacenter/cedar-project/issues/980 metadatacenter/cedar-project/issues/#980])
* Fixed an issue that caused class trees to reload every time a class was selected.
+
* Introduced a new version of owlapi-wrapper (OWL API v4.5.13)
* Fixed an issue with BioPortal's term selection widget that caused raw HTML to be displayed in search results.
+
* Updated Solr to version 8.2.0; introduced changes to the config files to conform to the latest version of Solr
* Fixed a problem in the REST API that caused an internal server error when accessing nonexistent users. The API now correctly displays a 404 not found message.
+
* Updated code to use secure protocol for password reset URLs ([https://github.com/ncbo/ontologies_linked_data/issues/98 ncbo/ontologies_linked_data#98])
* Fixed a bug that prevented flat tree ontologies from displaying in BioPortal.
+
 
* Fixed an issue that prevented the latest versions of the Gazetteer and Chemical Entities of Biological Interest ontologies from parsing.
+
 
* Fixed a problem that prevented visualization from working with private ontologies (thanks go to Eric Verbeek for this).
+
== BioPortal 5.11.0 (2019-February-13) ==
 +
 
 +
* Implemented the ability to index and efficiently search ontology branches ([https://github.com/ncbo/ontologies_linked_data/issues/90 ncbo/ontologies_linked_data#90])
 +
* Added path_to_root functionality to provisional classes
 +
* Migrated code to Google Analytics API v0.10; updated the library and the method calls to the new signatures
 +
* Added the ability to query properties on class descendants endpoint
 +
 
 +
 
 +
== BioPortal 5.8.0 (2018-April-26) ==
 +
 
 +
* Implemented a configurable number of retries for 4store failures ([https://github.com/ncbo/ontologies_linked_data/issues/84 ncbo/ontologies_linked_data#84])
 +
* Added a script for running SPAM deletion form the command line, added provisional classes to SPAM deletion artifacts ([https://github.com/ncbo/ncbo_cron/issues/13 ncbo/ncbo_cron#13])
 +
* Bug Fix: Recommender fails when input includes the word "concept" ([https://github.com/ncbo/ncbo_ontology_recommender/issues/7 ncbo/ncbo_ontology_recommender#7])
 +
* Fixed the pull process to ignore submission candidates that do not pass the OWLAPI parser ([https://github.com/ncbo/ncbo_cron/issues/10 ncbo/ncbo_cron#10])
 +
 
 +
 
 +
== BioPortal 5.6.0 (2017-December-19) ==
  
 +
* Added ontologyId field to the schema in preparation for Solr upgrade
 +
* Implemented the ability to browse flat ontologies in tree view ([https://github.com/metadatacenter/cedar-project/issues/407 metadatacenter/cedar-project/issues/#407])
 +
* Developed an endpoint to retrieve all ontologies with extended metadata ([https://github.com/metadatacenter/cedar-project/issues/660 metadatacenter/cedar-project/issues/#660])
 +
* Added the ability to sort terms in "/roots" and "/tree" endpoints ([https://github.com/metadatacenter/cedar-project/issues/409 metadatacenter/cedar-project/issues/#409])
  
== BioPortal Release 4.20 (August 2015) ==
 
  
''This release includes minor fixes from several previous releases.''
+
== BioPortal 5.3.1 (2017-May-22) ==
  
* Released a new version of the Ontology Recommender. This version is more flexible than the previous version and allows users to assign weights to the scores for various factors that influence the recommendation. In addition, some edge cases in the old system that resulted in bad recommendations have been addressed. This new recommendation system was developed independently by Marcos Martinez and then incorporated into our base code.
+
* Fixed an issue that prevented the [http://bioportal.bioontology.org/ontologies/HIV HIV ontology] from parsing.
* Instances (individuals) in an ontology can now be accessed through the API. Documentation for this is available at: http://data.bioontology.org/documentation#Instance.
+
* Fixed an issue that caused a 404 error in the BioPortal user interface when attempting to view the class tree of the HIV ontology.
* Components have been added to the Annotator UI to allow users to exercise additional options available through the API.
+
* Fixed an issue that prevented proper calculation of the set of root classes for the [http://bioportal.bioontology.org/ontologies/HP HP ontology].
* Icons now indicate non-subclass relationships in OBO ontologies. Previously it was not possible to distinguish visually OBO subclass from other OBO relations displayed in the tree (such as OBO part-of).
 
* The UMLS MeSH vocabulary is now displayed hierarchically. Previously it was displayed as a flat list of terms because of some problems with the hierarchical relation in the source that we were using.
 
* The Search API now allows search-by-name of provisional classes assigned to an ontology.
 
* The UMLS ontologies have all been updated to the latest 2015AA release.
 
* A new version of BioMixer with a simpler user interface has been incorporated into the system. This work was done by our collaborators at the University of Victoria.
 
* Created both a REST service and a UI for BioPortal application administration. This interface is automatically visible to VM administrators.
 
* Updated the framework of our system from RAILS version 2 to version 4.
 
* Fixed many bugs, especially those causing failures when parsing an ontology.
 
  
  
== BioPortal Release 4.14 (February 2015) ==
+
== BioPortal 5.3.0 (2017-May-02) ==
  
''This release includes minor fixes from several previous releases.''
+
This API-only release adds a suite of REST endpoints for retrieving ontology properties. It also addresses limitations with our auto-generated API documentation.
 
* The ontology summary page for each ontology now has a graph of recent history of the level of user-interface (UI) web traffic (number of page views) for that ontology. This graph is available under the “Metrics” box. See, for example, http://bioportal.bioontology.org/ontologies/SNOMEDCT . The raw data is also available for download in CSV format from the same location.
 
* The BioPortal home page now has a link that displays all ontologies in the system and the number of UI views for each ontology. Previously usage of only the top 5 ontologies were available.
 
* Users of our virtual machine now have the ability to plug in alternate concept recognizers for use by the annotator. To support these custom annotators, arbitrary parameters can be passed via the rest interface to the underlying concept recognizer. Documentation for how to make use of this feature is available on [https://github.com/ncbo/ncbo_annotator/wiki/Extending-Annotator-with-a-Custom-Concept-Recognizer GitHub].  Previously the “mgrep” concept recognizer was hardwired into the system and code modifications were required to employ another recognizer.
 
* Ontologies views can now be used for annotation. Previously only top level ontologies were available for use by the annotation system.
 
* All of PubMed has been indexed for use by the Resource Index for all terms in all ontologies in BioPortal. Previously only 18 months of PubMed data was indexed.
 
* We now provide for download, for all resources in BioPortal, files containing counts for term occurrence and co-occurrence (occurrence of pairs of terms in a document). These files can be used for research in enrichment analysis. Documentation of the files and how they might be used is available on [https://github.com/ncbo/resource_index/wiki/Term-Occurence GitHub].
 
* The ontology browse page now has a faceted interface that allows the list of displayed ontologies to be narrowed as desired. Previously all ontologies appeared in an alphabetical list but this became unwieldy with the 400+ ontologies that we now have.
 
* There is now a user-interface for displaying all of the properties in an ontology. If the properties were created in a hierarchy then this hierarchy is displayed. Previously only the class hierarchy was displayed. Properties were available programmatically though the REST interface but this information was not surfaced in the UI.
 
* Ontologies defined using SKOS are now supported. For these ontologies, the hierarchy is determined by the SKOS “broader” and “narrower” properties.
 
* We now allow download of all publically available ontologies in RDF. UMLS ontologies with restrictive licenses are excluded.
 
* We fixed a number of non-parsing ontologies and removed a bunch of low-content (“test”) ontologies.
 
* The system now contains the latest versions (2014AB) of all UMLS ontologies.
 
* We now treat all OBO synonym types as a BioPortal synonyms. Previously only the OBO “exact” synonym type was treated as a BioPortal synonym.
 
* We now notify by email the ontology authors if the nightly pull of their ontology fails.
 
  
 +
'''New Features'''
  
== BioPortal Release 4.10 (September 2014) ==
+
* Implemented an endpoint for retrieving property trees ([https://github.com/ncbo/ontologies_api/issues/27 ontologies_api/issues/27]). [http://data.bioontology.org/documentation#ObjectProperty Documentation]. [http://data.bioontology.org/ontologies/UBERON/properties/http%3A%2F%2Fpurl.obolibrary.org%2Fobo%2FRO_0002210/tree Example link].
 +
* Implemented an endpoint for retrieving property roots ([https://github.com/ncbo/ontologies_api/issues/28 ontologies_api/issues/28]). [http://data.bioontology.org/ontologies/UBERON/properties/roots Example link].
 +
* Implemented an endpoint for retrieving property parents ([https://github.com/ncbo/ontologies_api/issues/29 ontologies_api/issues/29]). [http://data.bioontology.org/ontologies/UBERON/properties/http%3A%2F%2Fpurl.obolibrary.org%2Fobo%2FRO_0002210/parents Example link].
 +
* Implemented an endpoint for retrieving property children ([https://github.com/ncbo/ontologies_api/issues/30 ontologies_api/issues/30]). [http://data.bioontology.org/ontologies/UBERON/properties/http%3A%2F%2Fpurl.obolibrary.org%2Fobo%2FRO_0002203/children Example link].
 +
* Implemented an endpoint for retrieving property ancestors ([https://github.com/ncbo/ontologies_api/issues/31 ontologies_api/issues/31]). [http://data.bioontology.org/ontologies/UBERON/properties/http%3A%2F%2Fpurl.obolibrary.org%2Fobo%2FRO_0002210/ancestors Example link].
 +
* Implemented an endpoint for retrieving property descendants ([https://github.com/ncbo/ontologies_api/issues/32 ontologies_api/issues/32]). [http://data.bioontology.org/ontologies/UBERON/properties/http%3A%2F%2Fpurl.obolibrary.org%2Fobo%2FRO_0002286/descendants Example link].
  
''This release includes minor fixes from several previous releases.''
+
'''Bug Fixes'''
 
* Reengineered the entire Resource Index to achieve better and more consistent performance and to align the Resource Index with the new BioPortal backend (released last year). In addition to allowing us to support additional resources, this revision removes a number of inconsistencies that resulted from the Resource Index using the old BioPortal backend.
 
* Upgraded the OWL and OBO parser to the latest version and reparsed all OBO and OWL ontologies. This reprocessing fixed a large number of problems with ontologies that either did not parse or that failed  search indexing or metrics calculations.
 
* We now create and make available for download a comma-separated value (CSV) file for most ontologies. These files have one row/class and a standard set of properties in the columns. We cannot make these files available for ontologies if the license for the ontology does not permit it (e.g. SNOMED-CT and MedDRA).
 
* Fixed PURLS for all ontologies. There were a large number of ontologies for which the PURLs we created, in the old system or the new one, no longer worked correctly.
 
* Reworked the entire mappings system so that mappings will be always up-to-date with the latest version of the ontologies.
 
* Created a web page (http://bioportal.bioontology.org/validate_ontology_file) so that users can validate that their ontologies parse correctly with the latest version of the OWL/OBO parser.
 
* Removed a number of bogus ontologies and spam notes.
 
* Fixed implementation of “longest only” parameter in Annotator.
 
* We now reparse and reindex an ontology if the administrator of the ontology changes the metadata for the ontology. The reparse  is necessary because the metadata contains information, such as the properties that contain synonyms or definitions, that influence the parsing and indexing.
 
* Recalculated metrics for all ontologies. This process filled in metrics for many ontologies that lacked them, and corrected the calculations of some metrics in other ontologies.
 
* We now allow the download of RDF (Turtle) files for UMLS ontologies whose license allows users to download them.
 
* Reindexing ontologies for search no longer interferes with the use of search on those ontologies. Previously search for an ontology was either broken or incomplete for an ontology that was being indexed.
 
* Added an ontology properties endpoint to the REST API. This endpoint allows a user to query for the properties used by an ontology.
 
 
As previously noted, we have permanently retired the old NCBO BioPortal API. New API documentation is available at
 
http://data.bioontology.org/documentation.
 
  
 +
* Fixed a bug that prevented the API documentation from being auto-generated for ontology properties endpoints ([https://github.com/ncbo/ontologies_api/issues/33 ontologies_api/issues/33]).
  
== BioPortal Release 4.6 (May 2014) ==
 
  
* Improved Search Result Display – Many ontologies contain classes that are references to a canonical ontology that “owns” the class. The system now automatically tries to identify the “owning” ontology and emphasize it in the results while displaying the ontologies that contain references to that ontology as subordinate (for that class). This feature is easier to try out than to explain. Type in “cancer” into the search box on the Search Tab and scan through the results to see what it is all about. This sort of display has been requested by a number of users for quite a while and we are happy to finally provide it.
+
== BioPortal 5.1.0 (2017-Apr-05) ==
* Implemented Search for ID (URI), UMLS CUI, UMLS TUI, and skos:notation – The search system now will use the input search to find a class URI, a class skos:notation field (“short id” in the old system) or a UMLS “concept unique identifier” or semantic type. All of these fields are available through the default search mechanism. There is still an optional “all properties” parameter to search these property values along with all other property values.
 
* Released New Version of BioMixer visualization system – The BioMixer system has been updated to improve performance and be more robust. (Work performed by our University of Victoria collaborators.)
 
* Implemented New Mapping Visualization – Mappings system now allows a user to visualize the strength of mappings relationships between ontologies. Go to the mappings tab, select an ontology, and hit the visualization radio button to try this out. (Work performed by our University of Victoria collaborators.)
 
* Implemented Configurable REST API calls – The Annotator and Search REST calls now allow a user specify which fields of a class the system should return. The user can also specify “all” to get everything.
 
* Updated UMLS Ontologies – All UMLS ontologies have been updated to the latest (2013 AB) version.
 
* Improved Autocomplete – The autocomplete in the ontology “Jump To” box, and in the widgets, now works more reliably with results that are more intuitive than previously.
 
* Provide Access Control for Mappings – We have implemented access control to prevent people other than the author from deleting a mapping.
 
* Reimplemented Annotator “Longest Only” Parameter – We have reimplemented the annotator “longest only” parameter to work in all situations. This parameter allows the user to limit the returned results to only those matches which are longer than other matches for a given ontology. In the old system this parameter did not work correctly.
 
* Reimplemented Widgets to not use Flash – We have reimplemented the widgets to not use the Adobe Flash technology. Requiring the use of this technology was unpopular among our user community.
 
* Enabled Upload and Download Large Ontologies – We have fixed various timeout problems which prevented users from uploading or downloading large ontologies.
 
* Fixed Bugs! – Fixed a very large number of bugs, some new with the new system, and some carried forward from the old system.
 
 
 
We've shut down access to the old BioPortal REST API and will be turning off the old system entirely in the near future. We've provided 7 months for application developers to move to the new system and the vast majority have already done so. The overwhelming response from developers has been the that new system is now (after a few post release glitches!) much easier to use and much more reliable than the old system. Documentation for the new API is available at: http://data.bioontology.org/documentation.
 
  
 +
This is an API release, which adds two new REST endpoints as well as a number of fixes and enhancements, designed to improve the asynchronous processing of ontology data.
  
== BioPortal Release 4.0 (September 2013) ==
+
'''New Features'''
  
The primary distinguishing feature of this release is the replacement of several backend storage and caching mechanisms with a single triple-store based backend built with on the open source 4store platform. In addition we are simultaneously releasing a new version of the BioPortal REST API. This API is also built on top of the triple store. It provides a much more uniform and REST-full interface to the underlying BioPortal data than our previous REST API.
+
* Implemented an endpoint for searching ontology properties ([https://github.com/ncbo/ontologies_api/issues/21 ontologies_api/issues/21]). [http://data.bioontology.org/documentation#nav_prop_search Documentation]. [http://data.bioontology.org/property_search?q=pref+label Example link].
 +
* Implemented an endpoint for retrieving a specific ontology property by its ID ([https://github.com/ncbo/ontologies_api/issues/22 ontologies_api/issues/22]). [http://data.bioontology.org/ontologies/BIBFRAME/properties/http%3A%2F%2Fid.loc.gov%2Fontologies%2Fbibframe%2FvoiceType Example link].
  
The old API will continue to function through the end of 2013. This API will only be able to access “old content” (that is, ontologies submitted or updated before today).  We encourage API users to transition as quickly as possible to the new API. The new API is the only way to access both new content (submitted after today) and old content. The reports from beta users of the new API have been uniformly positive.  Draft documentation for the new API is available at
+
'''Enhancements'''
http://data.bioontology.org/documentation
 
  
BioPortal users will note a few changes from the previous version. Some of these changes are temporary (we didn’t quite get everything done…) while others are permanent. There are also a number of minor and cosmetic changes. The list of the more important changes is available below.
+
* Improved logging of the CRON job processing
 +
* A more robust error handling of the CRON batch operations
 +
* A new CRON task that allows indexing ontology properties
 +
* An enhanced ontology processing script that now accepts a list of tasks to be performed
  
With a release of this size, it is inevitable that some bugs have crept in. Please report any that you run across to the support@bioontology.org mailing list. Have confidence that we will be working diligently to prioritize and fix the problems that arise.
+
'''Bug Fixes'''
  
Temporary Changes
+
* Fixed a bug that prevented mappings from being saved in a file correctly during processing ([https://github.com/ncbo/ontologies_linked_data/issues/70 ontologies_linked_data/issues/70]).
* All handling of obsolete classes in UI and API is not supported yet. Obsolete classes are currently indistinguishable from normal classes.
 
* “Slices” and ontology sets (user defined lists of ontologies of interest) are not supported yet
 
* The tree browse UI does not yet distinguish between is-a and part-of relations for OBO ontologies. Previously (and probably in the future) icons next to the class name indicated the relationship type.
 
* We do not yet have a VM version for this release. We expect to produce a new VM version by the end of the year. This VM will include the triple-store based storage mechanism. In addition VM users will be able to query the VM triple-store directly with SPARQL.
 
* Parsing of new ontologies and new versions remains disabled for the next few days. We will re-enable parsing by early next week.
 
  
Permanent Additions
 
* New ontologies and new versions of ontologies will be typically available for text annotation the next day after submission. Previously the process took several weeks to several months.
 
* We now have the latest versions UMLS ontologies. Previously we updated UMLS ontologies on request only, which left us with some very old versions. Going forward we will try to update our set of UMLS ontologies within a month of the UMLS release.
 
  
Permanent Subtractions
+
== BioPortal 5.0.0 (2017-Feb-06) ==
* Programmatic and browse access to classes in non-current versions of ontologies is removed. We still retain metadata about older versions of ontologies and we still allow you to download the source files for old versions.
 
* We no longer support Protégé Frames format ontologies. Owners of these ontologies will need to convert them to OWL or OBO to load them.
 
* We now use the owlAPI (http://owlapi.sourceforge.net/) to load OWL and OBO ontologies. This API supports OWL version 2.0. For almost all features, OWL 2.0 is a superset of OWL 1.0. There are some edge cases though where ontologies that marginally parsed with an OWL 1.0 parser will not parse at all with the OWL 2.0 parser. We leave it to OWL ontology owners to provide valid OWL 2.0 ontologies.
 
  
 +
This release represents an overhaul of our user interface, using bootstrap as the front-end framework to enable immediate and longer-term improvements. (Since the October 2016 release, we have also made a number of minor changes, mostly under the hood, and recently added a few significant features to the Recommender; Release Notes will be added shortly for those changes.)
  
== Previous BioPortal Releases ==
+
Please Note: Although we are aware of some bugs that have surfaced since the transition, so far they have been relatively minor and most can be worked around by re-sizing the page or changing tabs. We will be working to squash those bugs in the next few days, so please bear with us for this brief period.
  
For release notes for earlier releases, see
+
'''Enhancements'''
  
[[BioPortal Release 3 Release Notes]]
+
* Released new BioPortal user interface, including the features described below.
 +
* Implemented new UI framework based on boostrap, enabling cleaner management of all UI elements.
 +
* Redesigned the front page to provide cleaner and more informative look and feel, and put key features front and center.
 +
* Added graph to show top ontology access counts, replacing table with similar information.
 +
* Redesigned header to move most links to the menu bar, simplifying header and unifying it across all pages.
 +
* Redesigned footer to include appropriate and cleanly presented content, including social links, unified across all pages.
  
and
+
'''Bug Fixes'''
  
[[BioPortal Release 2 Release Notes]]
+
* Fixed an issue with the prompt for the ontology search on the front page, which would not produce desired results.
 +
* Fixed layout issues in front page header.

Latest revision as of 12:56, 4 February 2022

Please note: this page is deprecated and no longer updated. To view current release notes for BioPortal, please refer to one of the following pages:

BioPortal REST API release notes: https://github.com/ncbo/ontologies_api/releases
BioPortal web application release notes: https://github.com/ncbo/bioportal_web_ui/releases


This page contains software release notes for the 5.x series of BioPortal.

Use the following links to access release notes for the BioPortal Virtual Appliance, and older versions of BioPortal:



BioPortal 5.22.1 (2021-July-08, 2021-August-10)

Bug Fixes


BioPortal 5.21.0 (2021-May-18)

New Features

  • Further optimize the mapping counts generation job, including periodic 4store health checks (ncbo/ncbo_cron#40)
  • Added incremental progress logging to the Annotator dictionary generation job (ncbo/ncbo_annotator#16)

Bug Fixes


BioPortal 5.20.0 (2021-April-02)

New Features

  • A new CRON job that allows regenerating total mapping count and mapping count pairs on demand (ncbo/ncbo_cron#37)
  • An enhancement to the ontology pull process to allow clearing caches after the full run (ncbo/ncbo_cron#38)

Bug Fixes


BioPortal 5.19.0 (2020-September-04)

New Features

  • A new CRON job that synchronizes the search index with the master data stored in the triple store (ncbo/ncbo_cron#34)
  • An enhancement to the test runner script that uses a Dockerized instance of Redis for the tests run against

Bug Fixes


BioPortal 5.18.0 (2020-July-14)

New Features

  • Upgraded OWL API to version 4.5.17; updated the OWL API Wrapper to reflect this upgrade (owlapi_wrapper/releases/tag/v1.3.6)
  • In OWL API Wrapper, expanded the list of allowed suffixes for ontology files to include .n3, .nt, .nq, .skos, .rdf, and .rdfs (owlapi_wrapper/releases/tag/v1.3.6)
  • Implemented a script to allow an on-demand regenerating of the ontology admin report (ncbo/ncbo_cron#32)
  • Implemented a script to allow an on-demand regenerating of the ontology analytics data (ncbo/ncbo_cron#19)
  • Implemented a script to allow an on-demand regenerating of the ontology rank data (ncbo/ncbo_cron#31)

Bug Fixes


BioPortal 5.17.0 (2020-June-22)

New Features

Usage: bundle exec ruby run_tests.rb [options]

    -b, --backend [4store|ag]        An optional backend name. Default: 4store
    -v, --version VERSION            An optional version of the server to test against. Default: 'latest'
				     Must be a valid image tag published on repositories:
					https://hub.docker.com/r/bde2020/4store/tags for 4store
					https://hub.docker.com/r/franzinc/agraph/tags for ag
    -p, --port PORT                  An optional port number of the server to test against. Default: 9000 for 4store, 10035 for ag
				     Must be a valid integer value
    -f, --file TEST_FILE_PATH        An optional path to a test file to be run. Default: all test files
    -t, --test TEST_NAME             An optional name of the test to be run. Default: all tests
    -h, --help                       Display this screen

Bug Fixes

  • Fixed an issue running against AllegroGraph v7+ that prevented paged calls from completing properly (ncbo/goo#106)
  • Fixed an issue running against AllegroGraph v7+, where a test for ontology properties failed (ncbo/ontologies_linked_data#106)
  • Fixed an issue that caused Zlib::GzipWriter runtime errors during ontology processing (ncbo/ontologies_linked_data#107)
  • Removed a workaround that was implemented to address a bug in AllegroGraph v6+, which caused certain SPARQL queries to fail. AllegroGraph v7.0.1 release has addressed the issue (ncbo/goo#104)
  • Fixed an issue that caused runtime errors when running the code against Ruby 2.7.0 and Ruby 2.7.1 (ncbo/ontologies_api#69)
  • Fixed an issue, where a search on term id with exact match returns irrelevant results (ncbo/ontologies_api#57)
  • Fixed an issue, where a call to the class descendants endpoint fails if properties are included (ncbo/ontologies_api#54)


BioPortal 5.16.0 (2020-April-16)

New Features

Bug Fixes

  • Fixed an issue with AllegroGraph request chain breaking with existing Goo code (ncbo/goo#101)
  • Fixed an issue, where no parsed ontology records appeared in AllegroGraph after ontology has been parsed (ncbo/goo#102)
  • Fixed an issue with the paging calls returning wrong results in AllegroGraph (ncbo/goo#103)


BioPortal 5.14.0 (2019-December-09)

  • Implemented a number of enhancements that drastically improved performance of the class descendants call (metadatacenter/cedar-project/issues/#980)
  • Introduced a new version of owlapi-wrapper (OWL API v4.5.13)
  • Updated Solr to version 8.2.0; introduced changes to the config files to conform to the latest version of Solr
  • Updated code to use secure protocol for password reset URLs (ncbo/ontologies_linked_data#98)


BioPortal 5.11.0 (2019-February-13)

  • Implemented the ability to index and efficiently search ontology branches (ncbo/ontologies_linked_data#90)
  • Added path_to_root functionality to provisional classes
  • Migrated code to Google Analytics API v0.10; updated the library and the method calls to the new signatures
  • Added the ability to query properties on class descendants endpoint


BioPortal 5.8.0 (2018-April-26)


BioPortal 5.6.0 (2017-December-19)


BioPortal 5.3.1 (2017-May-22)

  • Fixed an issue that prevented the HIV ontology from parsing.
  • Fixed an issue that caused a 404 error in the BioPortal user interface when attempting to view the class tree of the HIV ontology.
  • Fixed an issue that prevented proper calculation of the set of root classes for the HP ontology.


BioPortal 5.3.0 (2017-May-02)

This API-only release adds a suite of REST endpoints for retrieving ontology properties. It also addresses limitations with our auto-generated API documentation.

New Features

Bug Fixes

  • Fixed a bug that prevented the API documentation from being auto-generated for ontology properties endpoints (ontologies_api/issues/33).


BioPortal 5.1.0 (2017-Apr-05)

This is an API release, which adds two new REST endpoints as well as a number of fixes and enhancements, designed to improve the asynchronous processing of ontology data.

New Features

Enhancements

  • Improved logging of the CRON job processing
  • A more robust error handling of the CRON batch operations
  • A new CRON task that allows indexing ontology properties
  • An enhanced ontology processing script that now accepts a list of tasks to be performed

Bug Fixes


BioPortal 5.0.0 (2017-Feb-06)

This release represents an overhaul of our user interface, using bootstrap as the front-end framework to enable immediate and longer-term improvements. (Since the October 2016 release, we have also made a number of minor changes, mostly under the hood, and recently added a few significant features to the Recommender; Release Notes will be added shortly for those changes.)

Please Note: Although we are aware of some bugs that have surfaced since the transition, so far they have been relatively minor and most can be worked around by re-sizing the page or changing tabs. We will be working to squash those bugs in the next few days, so please bear with us for this brief period.

Enhancements

  • Released new BioPortal user interface, including the features described below.
  • Implemented new UI framework based on boostrap, enabling cleaner management of all UI elements.
  • Redesigned the front page to provide cleaner and more informative look and feel, and put key features front and center.
  • Added graph to show top ontology access counts, replacing table with similar information.
  • Redesigned header to move most links to the menu bar, simplifying header and unifying it across all pages.
  • Redesigned footer to include appropriate and cleanly presented content, including social links, unified across all pages.

Bug Fixes

  • Fixed an issue with the prompt for the ontology search on the front page, which would not produce desired results.
  • Fixed layout issues in front page header.